Initial commit
This commit is contained in:
commit
57fc3525eb
7311 files changed
+1291398
No files matched your search
@@ -0,0 +1,27 @@
|
||||
# 异常处理规范(R2-7)
|
||||
|
||||
## 原则
|
||||
|
||||
1. **捕获具体的异常类型。**
|
||||
- 类型转换:`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`。
|
||||
2. **确有必要的宽泛捕获,在 except 行注明理由**:`except Exception: # broad-except: 理由`。典型场景:
|
||||
- 回滚或清理之后原样重新抛出;
|
||||
- 尽力而为的收尾操作(关闭连接、清理缓存);
|
||||
- 接口层把任何内部错误转换为 HTTP 错误码;
|
||||
- 指标抓取、心跳这类绝不能让调用方失败的路径。
|
||||
3. **不要静默吞掉异常。** 至少记一条 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 处。
|
||||
Reference in new issue
Block a user