支付代码审查 是做什么的?
找出支付代码中真正造成资金损失的 bug,并以金钱的角度解释每一个问题:谁被重复扣款、哪笔记账丢失、谁可以批准自己的转账。
工作流程
-
划定范围。 找出创建、移动、批准、记账或对账资金的代码:控制器、服务、监听器、实体、迁移。记录技术栈(Spring Boot、Kafka、JPA、Kotlin)。
-
运行扫描器 从本技能所在的文件夹针对项目或变更文件执行:
python scripts/scan.py <代码路径> # 输出 markdown 表格 python scripts/scan.py <代码路径> --format json # 供进一步处理需要 Python 3.10+,无需其他依赖。除非传入
--include-tests,否则它会跳过测试源代码。它通过启发式规则读取源码,因此输出是一系列线索。 -
通过阅读代码验证每一个发现。 对每一条线索,打开文件并确认:
- 名为
amount的double如果实际是百分比或比率,则不构成 PAY001。 - 如果重复或四眼检查存在于扫描器跟踪范围(三次调用)更深的位置,则消费者或批准方法没有问题。跟踪下去并说明位置。
- 剔除误报,并用一句话说明原因,以便读者信任其余结果。
- 名为
-
执行手动检查清单 参见 references/checklist.md。其中对每条扫描规则给出了错误和正确示例,并列出了扫描器无法发现的内容:余额竞态、幂等键范围、重试加超时语义、状态机、对账、在途资金、审计和数据保护。只深入到当前审查代码所需的程度。
-
撰写报告 按照以下格式。以资金影响最大的问题开头。
报告格式
## 支付审查:<服务或PR>
**结论:** <一句话:可安全合并 / 修复后再合并 / 需要重新设计>
| # | 严重程度 | 位置 | 问题 | 资金影响 |
|---|---|---|---|---|
| 1 | 高 | `TransferController.java:24` | POST /transfers 缺少幂等键 | 客户端超时后重试会创建第二笔转账 |
### 1. <标题>
**为何重要:** <具体说明什么会出错,附带一个示例金额>
**修复:** <最小安全变更,附带简短代码片段>
### 已检查且无误
- <验证为正确的内容及其位置;确保审查诚实>
### 未涵盖
- <无法检查的内容,例如不在此仓库中的数据库约束>
审查规则
- 严重程度基于资金影响。 高 = 资金可能丢失、重复或被错误的人转移。中 = 在故障或负载下可能发生。低 = 规范性问题。
- 引用具体行,格式为
文件:行号,每个发现都必须如此。绝不报告未经确认的扫描器线索。 - 优先选择最小的安全修复,例如添加唯一约束加
Idempotency-Key请求头,而不是重写。当正确的修复是结构性的(如事务性发件箱)时,应明确说明。 - 不要声称合规。 此审查并非 PCI DSS 或 SOX 审计;如果被问及,应明确说明。
- 也要检查数据库。 许多保障应属于约束(
UNIQUE、CHECK、触发器)。查看仓库中的迁移脚本(Flyway、Liquibase)。