Python 使用 `raise` 报错抛出异常显示 Unicode 码如何解决

在 Python 开发中我们经常使用raise抛出异常来处理错误情况。但有时候异常信息中的中文或其他非 ASCII 字符会被显示为 Unicode 转义序列如\u6b63\u6587而不是直接显示中文如“正文”。这不仅影响可读性还可能让调试变得困难。本文将详细分析这个问题并提供解决方案。1. 问题重现1.1 示例代码假设我们有一个函数check_paragraph_order()用于检查文档段落编号是否正确排序。如果发现异常则抛出异常并附带错误信息importjsondefget_paragraph_info():# 模拟返回段落信息包含中文return{type:paragraph,index:179,content:1建设业务经营形成“国内国际新基建”三轮驱动,label:[正文]}defcheck_paragraph_order():paragraph_infoget_paragraph_info()# 模拟检查失败抛出异常raiseException(json.dumps({error_msg:正文编号排序异常,detail_msg:paragraph_info}))try:check_paragraph_order()exceptExceptionase:print(f捕获到异常:{e})1.2 运行结果运行上述代码后控制台输出捕获到异常: {error_msg: \u6b63\u6587\u7f16\u53f7\u6392\u5e8f\u5f02\u5e38, detail_msg: {type: paragraph, index: 179, content: \uff081\uff09\u5efa\u8bbe\u4e1a\u52a1\u7ecf\u8425\uff1a\u5f62\u6210\u201c\u56fd\u5185\u56fd\u9645\u65b0\u57fa\u5efa\u201d\u4e09\u8f6e\u9a71\u52a8\uff1b, label: [\u6b63\u6587]}}可以看到error_msg中的“正文编号排序异常”被显示为\u6b63\u6587...。detail_msg中的中文也被转义为 Unicode 编码。2. 问题原因2.1json.dumps()默认行为json.dumps()是 Python 中将字典转换为 JSON 字符串的方法。默认情况下json.dumps()会将所有非 ASCII 字符如中文、日文、韩文等转义为 Unicode 编码如\u6b63。这是 JSON 规范的一部分目的是确保 JSON 字符串在所有环境中都能安全传输避免编码问题。2.2 控制台打印时的显示当我们print(Exception(...))或捕获异常后打印时Python 会调用str()方法而Exception的str()方法会直接显示json.dumps()的结果包含 Unicode 转义。因此控制台看到的是\u6b63\u6587...而不是直接显示中文。3. 解决方案3.1 方法 1使用ensure_asciiFalse最简单的方法是在json.dumps()中添加参数ensure_asciiFalse强制保留非 ASCII 字符如中文raiseException(json.dumps({error_msg:正文编号排序异常,detail_msg:get_paragraph_info()},ensure_asciiFalse))运行结果捕获到异常: {error_msg: 正文编号排序异常, detail_msg: {type: paragraph, index: 179, content: 1建设业务经营形成“国内国际新基建”三轮驱动, label: [正文]}}优点直接显示中文可读性高。保留 JSON 结构的机器可读性。适用场景需要异常信息既可读又可被程序解析时。3.2 方法 2手动解析 JSON 字符串不推荐如果无法修改json.dumps()的调用可以捕获异常后手动解析 JSON 字符串try:check_paragraph_order()exceptExceptionase:error_jsonstr(e)# 获取 JSON 字符串含 Unicodeerror_dictjson.loads(error_json)# 解析 JSON 回字典print(f错误信息:{error_dict[error_msg]})# 直接访问中文字段运行结果错误信息: 正文编号排序异常缺点代码冗余需要额外解析 JSON。仅适用于简单场景不推荐广泛使用。3.3 方法 3直接构造错误信息避免 JSON 转换如果错误信息不需要 JSON 结构可以直接用字符串拼接defcheck_paragraph_order():paragraph_infoget_paragraph_info()error_msgf正文编号排序异常详情:{paragraph_info}raiseException(error_msg)运行结果捕获到异常: 正文编号排序异常详情: {type: paragraph, index: 179, content: 1建设业务经营形成“国内国际新基建”三轮驱动, label: [正文]}优点简单直接无需 JSON 转换。适用于错误信息不需要机器解析的场景。缺点丢失 JSON 结构不利于程序化处理。4. 最佳实践方案适用场景推荐指数json.dumps(..., ensure_asciiFalse)需要异常信息既可读又可被程序解析⭐⭐⭐⭐⭐手动解析 JSON 字符串无法修改json.dumps()调用⭐⭐直接构造错误信息错误信息不需要 JSON 结构⭐⭐⭐推荐方案优先使用ensure_asciiFalse因为它既保留了 JSON 结构又让中文直接显示。如果错误信息不需要 JSON 结构可以直接用字符串拼接。5. 总结问题原因json.dumps()默认转义非 ASCII 字符如中文为 Unicode 编码。解决方案ensure_asciiFalse推荐强制保留中文直接显示。手动解析 JSON不推荐适用于无法修改源码的情况。直接构造字符串适用于简单错误信息。最佳实践优先使用ensure_asciiFalse兼顾可读性和机器可解析性。6. 完整代码示例importjsondefget_paragraph_info():return{type:paragraph,index:179,content:1建设业务经营形成“国内国际新基建”三轮驱动,label:[正文]}defcheck_paragraph_order():paragraph_infoget_paragraph_info()# 使用 ensure_asciiFalse 保留中文raiseException(json.dumps({error_msg:正文编号排序异常,detail_msg:paragraph_info},ensure_asciiFalse))try:check_paragraph_order()exceptExceptionase:print(f捕获到异常:{e})运行结果捕获到异常: {error_msg: 正文编号排序异常, detail_msg: {type: paragraph, index: 179, content: 1建设业务经营形成“国内国际新基建”三轮驱动, label: [正文]}}7. 扩展阅读Pythonjson.dumps()官方文档Unicode 与 UTF-8 编码详解Python 异常处理最佳实践希望本文能帮助你解决 Python 异常信息显示 Unicode 码的问题