Python中UnicodeDecodeError无法显示自定义args消息求助

UnicodeDecodeError和ZeroDivisionError这类通用异常的核心差异在于字符串表示的实现逻辑：

• ZeroDivisionError的__str__方法会直接拼接args元组内的所有元素，所以追加自定义字符串到args后，回溯输出会自动显示新增内容。
• UnicodeDecodeError是结构化异常，它的args固定包含5个核心参数：(encoding, reason, object, start, end)，其__str__方法仅基于这5个参数生成显示文本，完全忽略args中额外追加的元素。哪怕你把自定义消息加到args末尾，回溯输出只会展示由核心参数生成的默认错误信息。

方法1：修改错误原因并重新抛出同类型异常 #

将自定义消息整合到原异常的reason字段中，构造新的UnicodeDecodeError抛出，同时保留原异常的上下文追踪链：

import json

try:
    with open("invalid_utf8_file.json", "r") as data_file:
        json_data = json.load(data_file)
except UnicodeDecodeError as e:
    # 把自定义提示合并到原错误原因里
    updated_reason = f"{e.reason} - 自定义提示：请检查文件是否为UTF-8编码"
    # 复用原异常的核心参数，构造新异常
    new_exception = UnicodeDecodeError(
        e.encoding,
        e.object,
        e.start,
        e.end,
        updated_reason
    )
    # 保留原异常的追踪上下文
    raise new_exception from e

这种方式会让回溯信息里的错误原因直接包含自定义内容，和原生异常的显示风格完全一致。

方法2：抛出包装类异常（保留原异常上下文） #

如果不需要严格保持UnicodeDecodeError的类型，可以抛出通用异常并关联原异常，既显示自定义消息，又保留原错误细节：

import json

try:
    with open("invalid_utf8_file.json", "r") as data_file:
        json_data = json.load(data_file)
except UnicodeDecodeError as e:
    raise RuntimeError(f"JSON文件解码失败：自定义提示 - 文件编码不符合要求") from e

回溯时会先展示自定义的RuntimeError信息，再显示原UnicodeDecodeError的详细错误。

方法3：手动打印自定义消息（不修改异常） #

如果只是需要在控制台看到自定义提示，不需要修改回溯输出，可以在捕获异常时先打印消息，再重新抛出原异常：

import json

try:
    with open("invalid_utf8_file.json", "r") as data_file:
        json_data = json.load(data_file)
except UnicodeDecodeError as e:
    print(f"自定义提示：文件解码出错！原错误：{e}")
    raise

内容的提问来源于stack exchange，提问作者munkykisser