2.2 KiB
2.2 KiB
异常处理规范(R2-7)
原则
- 捕获具体的异常类型。
- 类型转换:
int()、float()用(TypeError, ValueError, OverflowError);json.loads()用(TypeError, ValueError, RecursionError)(JSONDecodeError是ValueError的子类)。 - 读写文件:
OSError(包括FileNotFoundError、PermissionError)。 - 解析数据:
ValueError(UnicodeDecodeError也是它的子类)。 - 浏览器操作:
app.core.driver的驱动异常,包括ContextLost(页面刷新或导航,稍后重试即可)、DriverDisconnected、DriverTimeout、ScriptError,基类是DriverError。
- 类型转换:
- 确有必要的宽泛捕获,在 except 行注明理由:
except Exception: # broad-except: 理由。典型场景:- 回滚或清理之后原样重新抛出;
- 尽力而为的收尾操作(关闭连接、清理缓存);
- 接口层把任何内部错误转换为 HTTP 错误码;
- 指标抓取、心跳这类绝不能让调用方失败的路径。
- 不要静默吞掉异常。 至少记一条 debug 日志(
logger.debug(..., exc_info=True)),排查问题时才有线索。
收窄时的注意事项
try块里的每一个表达式都可能抛出异常,而不只是你关心的那个调用。int(data["x"])会先抛KeyError,float(cfg.get("a"))在cfg为None时会抛AttributeError。收窄前要确认try块里没有别的可能出错的表达式;如有,要么一并列出它们的异常类型,要么把它们移出try。- 驱动层只翻译 DrissionPage 自身的异常,Python 内置异常(
TypeError、OSError等)原样抛出。所以依赖except TypeError做兼容退回的代码不受影响。
棘轮
tests/test_exception_ratchet.py 按文件统计宽泛捕获的数量,只减不增,基线在 tests/fixtures/broad_except_ratchet.json。收窄之后运行 python tests/test_exception_ratchet.py --update,把进度锁定。
- 起点:1511 处。
- R2-7 做了两件事:一是机械收窄 50 处「
try里只有一句类型转换、参数是变量或常量」的写法;二是对新模块逐个审阅,收窄或注明了 28 处。现为 1433 处。