docs: 补充查询次数与加锁形态规则
This commit is contained in:
@@ -47,3 +47,19 @@ Javadoc 描述的方法名、参数、返回跟下面那个方法对不上就是
|
||||
新增英文注释、或把中文提示改成英文都算违规:这个项目的用户文案与注释都是中文,混语种会在同一屏里跳出来。
|
||||
用户文案还要求口语化(见 `api-response.md`)。历史情况(2026-11-19 前)是混排:`ReviewRecallController:21`、`LoginResult:21` 这类成句英文注释要翻成中文;
|
||||
`/** REPORT | FRAGMENT */` 这种字段取值说明不算违规。
|
||||
|
||||
## 并发与性能
|
||||
|
||||
### 9. 循环里发查询(N+1)
|
||||
|
||||
`for` / `stream.map` / `forEach` 里出现 `selectOne` / `selectById` / `selectList` / `exists` 就是违规:请求的 SQL 条数会随
|
||||
行数或子记录数线性增长,而库在远端,单程 40–80ms。识别方式是看循环体内有没有 mapper 调用、以及列表 DTO 的字段是不是
|
||||
「每行再查一次」补出来的。改法:收集 id/编号 → 一条 `IN` 取齐 → 内存建 Map 装饰;聚合类下推 SQL。
|
||||
2026-11-21 回忆列表(47 → 7 条)、导出范围(4+5×T → 9 条)已按此收敛。
|
||||
|
||||
### 10. 取锁写法会在并发下死锁
|
||||
|
||||
同一事务里先 `INSERT IGNORE`(或普通 `INSERT`)拿 S 锁、再 `SELECT ... FOR UPDATE` 升级 X 锁,两个并发请求必然死锁,
|
||||
表现为接口随机 500,且只在「首次进入页面」这类并发场景出现。识别:锁表的取锁语句是不是两步。
|
||||
改法见 `data-access.md`「加锁形态」:锁行可能不存在时用 `INSERT ... ON DUPLICATE KEY UPDATE` 再 `FOR UPDATE`,
|
||||
并用两个并发请求验证。
|
||||
|
||||
Reference in New Issue
Block a user