# Java 接口契约与可维护性检查清单

## 公开 API 与兼容性

- 对外接口（REST path、请求/响应 DTO、公开库 API）变更是否破坏向后兼容（删除字段、改语义、改 HTTP 状态约定）。
- 序列化边界（JSON/XML）是否与 `record`/getter 命名、注解一致，避免静默字段丢失。

## Spring / Web 层（仅当 diff 呈现相关注解或类型时）

- 控制器方法参数校验是否缺失（`@Valid`、`@NotNull` 等与 DTO 是否匹配）。
- `GET` 是否误带 body；`POST` 幂等与安全头是否在明显错误时出现。
- 路径变量与查询参数是否与权限注解或业务假设一致（仅当 diff 可证时）。

## 可读性与职责

- 方法过长或类职责过多是否在本次变更中明显恶化。
- 魔法数字与字符串是否应在常量或配置中集中（仅当重复或高风险时指出）。

## 测试与可维护性

- 关键分支或回归点是否在 diff 中缺少对应测试更新。
- 测试是否依赖顺序、全局可变状态或真实外部服务且无隔离（diff 可见时）。