Python如何精准输出异常信息（含行号与堆栈）

快速获取完整异常信息（自动包含行号）

在Python中处理异常时，开发者常需要同时查看具体的错误原因以及触发位置（文件路径与精确行号）。现代Python标准库已提供成熟的工具链，无需依赖不稳定的内部变量即可直接获取这些信息。

第1步：使用 traceback 模块获取堆栈与行号

目的：在异常发生处立即打印出完整的执行轨迹、文件名、行号及错误详情。入口：内置 traceback 模块。动作：在 try-except 捕获块内调用 format_exc() 或 print_exc()。该函数默认会解析当前调用栈，并自动附带报错位置的行号。

import traceback

try:
    result = 10 / 0
except Exception as e:
    # format_exc() 返回带换行的完整字符串，可直接写入日志或变量
    error_detail = traceback.format_exc()
    print(error_detail)

第2步：利用 logging 记录异常（生产环境推荐）

目的：将异常信息持久化至日志系统，便于后续追溯。入口：logging 模块。动作：使用 logger.exception() 或配置 exc_info=True。该方法会在记录 ERROR 级别日志的同时，自动追加完整的 traceback 堆栈信息。

import logging

logger = logging.getLogger(__name__)

try:
    # 模拟业务逻辑
    pass
except RuntimeError as e:
    # 方案A：直接使用 exception，自动绑定 exc_info
    logger.exception("数据库操作失败")
    
    # 方案B：普通 error 方法附加 exc_info
    logger.error("SQL执行异常: %s", str(e), exc_info=True)

常见异常捕获与控制流程

第3步：try-except-raise 控制流

目的：按需拦截特定错误，决定是就地修复、忽略还是向上传播。入口：基础语法结构。动作：except 用于捕获并处理；若捕获后仍需向上层传递，可使用 raise 语句重新抛出原始异常或携带新上下文。

try:
    data = fetch_remote_data()
except ConnectionError as e:
    # 仅记录警告，允许程序继续运行或降级处理
    print("网络波动，使用缓存数据")
    data = get_cached_data()
finally:
    # 无论是否发生异常，清理资源必执代码块
    release_connection_pool()

第4步：自定义异常与类型转换

目的：区分底层报错与业务逻辑错误，提升异常可读性。入口：继承 Exception 基类。动作：创建自定义异常类；或在 except 块中使用 raise NewError(msg) 将原生异常转换为业务异常。

class ConfigLoadError(Exception):
    """配置文件加载失败的自定义异常"""
    pass

try:
    load_config("config.yaml")
except FileNotFoundError as e:
    # 将IO错误转为更具业务语义的类型
    raise ConfigLoadError("找不到关键配置文件") from e
except ValueError as e:
    # 也可不带参数原样抛出，保持原始堆栈不变
    raise

测试场景中的异常反馈技巧

第5步：单元测试框架的断言失败反馈

目的：在自动化测试中快速暴露数据校验偏差。入口：测试框架（如 unittest、pytest）。动作：使用断言方法（如 assertEqual、assertTrue）。当条件不满足时，框架会自动中断当前用例并输出详细的期望值与实际值对比及行号。

def test_response_status():
    res = requests.get(api_url)
    # 状态码非200时自动抛出 AssertionError 并附带详细报告
    assert res.status_code == 200, f"请求失败: {res.text}"
    assert res.json()["status"] == "success"