Java Backend Guardrails

Java Backend Guardrails（总控）

定位：把面试考点变成写代码时的风险扫描，不是背题，也不是自动写出完美代码。 技术栈默认：Java 微服务 + Spring Boot + MyBatis-Plus + Redisson + RocketMQ。

硬规则

1. 先读本文件，再按需加载子 skill。 禁止把所有子 skill 读进上下文。
2. 最多加载 2–4 个子 skill。 用下面的路由表匹配，取相关度最高的。
3. 普通单表 CRUD（无钱、无库存、无回调、无跨服务写、无公开高 QPS）→ 不加载任何高并发子 skill。 只做安全与表设计里的轻量检查（#{}、登录鉴权、必要唯一约束）。
4. 先给轻量方案。 禁止无脑上 TCC、Seata、分库分表、全局分布式锁。升级重方案必须写清触发条件。
5. skill 给风险 + 对比 + 默认路径，取舍交给人。 不要假装只有一种正确答案。
6. 写完代码后按已加载子 skill 的评审清单再扫一遍。

工作流

按当前阶段只加载该阶段相关的子 skill：

两种触发：

• 语义自动： 识别到下方关键词就加载对应子 skill。
• 显式： 用户点名某个 skill（如「用幂等 skill」）时只读那一个。

路由表（只读命中的文件）

路径相对本 skill 根目录。索引和分片是两个文件，禁止当作同一个问题处理。

组合场景组合（仍然 ≤4）：

轻量默认（未加载子 skill 时也遵守）

• 写操作：数据库唯一约束 / 条件更新，优先于分布式锁。
• 重试：先幂等，再重试。超时当未知结果，禁止当失败直接再做一笔。
• 缓存：缓存不是数据源。写库成功后再删缓存。
• 消息：按至少一次投递设计，消费者必须幂等。
• 远程调用：必须设超时。非幂等接口禁止自动重试。
• 分库分表、TCC、Seata、异地多活：默认不上。
• 读写分离后，资金/核销/写后读走主库。
• Redis Cluster 槽位 ≠ 一致性哈希；索引 ≠ 分片 ≠ 主从。
• 一次性延迟 ≠ 周期性定时；接口慢先 Trace，不要先加缓存/加连接池。
• 文件不进 MySQL；OSS 密钥不进前端；用户文件名不当 object key。

输出形状

## 判定
- 场景:
- 命中关键词:
- 加载的子 skill: （≤4，写相对路径）
- 明确跳过: （如 TCC / 分库分表 / 分布式锁）

## 风险
- （只列本次相关的面试级坑）

## 方案
- 默认（轻量）:
- 何时升级:

## 落地
- 表 / 唯一键 / 状态机:
- 代码要点:

## 评审
- （按已加载子 skill 清单勾）

禁止

• 简单列表查询输出限流 + 分库分表 + TCC。
• 把索引方案写进分片 skill，或把分片方案写进索引 skill。
• 把扫表关单写进定时任务 skill（应走 delay-job）；把 Full GC 写进接口性能 skill。
• 把 STS/直传写进上传安全 skill，或把 magic/SSRF 写进 OSS skill。
• 用「面试标准答案」压过当前业务体量。
• 只给概念不给可落地的约束（唯一键、WHERE 条件、超时值来源）。