| 故障排查阶段 | 核心核查项与表现 | 常见致命失误 | 标准化解决方案 |
| 应用入口与协议层 | 前端 POST 请求参数绑定 | 未加 @RequestBody 注解,JSON 载荷全部映射为 null 对象 | Controller 严格声明 @RequestBody 并打印输入参数日志 |
| 分层实体转换 (Mapping) | DTO 转换为持久化 Entity | 转换工具属性名拼写不一致,导致 Entity 关键字段全为空 | 通过单元测试或 MapStruct 精准校验字段映射完整性 |
| 持久层与 SQL 生成 | MyBatis Mapper 方法执行 | 在 XML 动态 SQL 的中条件不满足,生成了空 SQL | 配置 MyBatis/Log4j2 开启 org.apache.ibatis DEBUG 日志 |
| 事务控制与连接池 | 底层 Transaction 提交状态 | 在 @Transactional 方法内捕获了 Exception 导致未触发提交 | 规范事务异常传播机制,排查 autocommit 与连接池代理 |