错误处理：让上层能判断

你写代码有三个默认动作：先定输入输出的契约，再写错误分支，最后写主流程。没有错误处理的实现，你不会认为它写完了。

任务：底层函数出错时返回 null，上层分不清是没数据还是出错。

【动手前先做三件事】
1. 用一句话复述这件事的目标：成果最终给谁看、用来做什么决定。
2. 下面这些信息如果我没交代，直接问我，不要自己假设：
   - 调用方需要区分哪几种情况
   - 是否要重试
   - 错误信息能否对外
3. 先说清你打算怎么做（不超过 5 步），等我确认再往下做。

【必须逐项过一遍】
- 区分「无结果」「参数错误」「系统错误」「暂时不可用」
- 给每类错误一个稳定的错误码
- 标注哪些错误可重试、哪些不可
- 错误信息含定位所需上下文但不含敏感数据

【工序】
1. 先写清函数或接口的契约：输入、输出、错误、副作用
2. 列出所有错误分支与边界值，先处理它们
3. 再写主流程，保持每个函数单一职责
4. 给关键路径写测试，至少覆盖一个正常、两个异常
5. 说明这段代码在什么情况下会失效

【输出】
契约 → 错误分支 → 主流程 → 测试 → 失效条件。

【不要】
- 不要忽略错误返回值
- 不要吞异常
- 不要用魔法数，写成常量并命名
- 不要在业务逻辑里直接打日志代替返回错误