开发日记:SpringBoot + MyBatis 完成新增数据利用后,数据库没有出现该条数据

[复制链接]
发表于 8 小时前 | 显示全部楼层 |阅读模式

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有账号?立即注册

×
核心结论与决策建议(BLUF)
在 Spring Boot + MyBatis / MyBatis-Plus 技术栈开发中,当客户端发送 POST 接口请求收到 200 成功响应,但底层 MySQL 数据库中却没有插入目标数据时,问题绝大多数出在“业务分层实体转换漏传导致关键字段丢失”、“事务隐式回滚或 `@Transactional` 代理失效”、“双数据源配置下写入了非目标库或读写分离主从延迟”、以及“MyBatis 执行器缓存或拦截器静默拦截”。开发排查切忌盲目猜测,必须建立标准化排查矩阵:第一步打开 SQL 执行与参数绑定全量日志日志;第二步核查 Controller、DTO、Entity 各层数据对象转换链路;第三步审查事务提交与底层连接池配置。

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


一、事故现象重现:接口返回成功但数据库空空如也
在开发分类维护功能时,通过 Postman 发起 POST 新增分类请求,控制台输出 200 状态,且业务码返回成功:

然而连接 MySQL 数据库执行
  1. SELECT * FROM subject_category
复制代码
,却根本没有新增的数据记录!

二、全链路排查实战:分层数据对象传递诊断

2.1 核查 DTO 与 Entity 的结构差异
在现代领域驱动设计(DDD)中,数据流转跨越多个层级:


如图所示,
  1. SubjectCategoryDTO
复制代码
承载前端交互,而持久层需要
  1. SubjectCategoryBO
复制代码
或 Entity 实体。如果在转换阶段使用了属性拷贝工具(如 BeanUtils),而两者的属性名大小写或类型略有出入,会导致实体对象的所有属性均为 NULL,最终写入失败。

2.2 领域服务层持久化调用验证

在调用
  1. domainService.add()
复制代码
时,必须确认数据是否真正传递到了底层 DAO 接口。

三、关键破局法宝:开启全链路日志监控监控与数据流跟踪
若缺乏日志,排查犹如盲人摸象。必须引入标准日志体系捕获真实的参数状态。


3.1 引入日志与序列化依赖
在模块的
  1. pom.xml
复制代码
中引入 Log4j2 与高性能序列化组件:



3.2 在代码关键链路埋点追踪
在业务方法上声明
  1. @Slf4j
复制代码
,将每一层入参序列化输出:



3.3 配置日志输出规则与 MyBatis SQL 打印
在
  1. resources
复制代码
目录下配置
  1. log4j2-spring.xml
复制代码
:

并配置输出级别:

  1. -- 在 application.yml 中开启持久层包级别的 DEBUG 日志
  2. logging:
  3.   level:
  4.     com.example.mapper: DEBUG
  5.     org.springframework.jdbc.datasource.DataSourceTransactionManager: DEBUG
复制代码


通过日志最终查明原因:在 MyBatis XML 中由于编写了错误的动态过滤标签(例如误写了
  1. test="categoryName != null and categoryName != ''"
复制代码
但前端传过来的是空字符串),导致整个动态
  1. INSERT
复制代码
拼装成了一条空语句,DAO 层返回受影响行数为 0,但应用层没有针对返回值做有效性校验,从而引发了“虚假成功”事故。

四、防范此类故障的四项架构军规
1. 严格检查受影响行数:在执行 Mapper 的
  1. insert
复制代码
或
  1. update
复制代码
方法后,必须校验返回值:
  1. int rows = mapper.insert(entity); if (rows <= 0) throw new BusinessException("写入数据库失败");
复制代码
;
2. 确保实体映射类型严格匹配:避免无脑使用浅拷贝反射工具,推荐采用编译期强类型映射工具 MapStruct;
3. 正确识别多数据源上下文:若系统集成了主从数据源,必须确认新增操作使用的是主库数据源路由,避免刚写入主库立刻去从库查询时因毫秒级同步延迟导致误判为未插入。

常见问题(FAQ)
Q1: 为什么日志中显示打印了 INSERT 语句且参数正常绑定,但直接去 MySQL 客户端查看依然没有数据?
A1: 这是极其典型的事务未提交(No Commit / Rollback)现象。常见原因包括:在方法中开启了事务,但在外层捕获了异常且没有正确显式调用事务提交;或者测试用例上标注了 Spring 的
  1. @Rollback(true)
复制代码
默认回滚注解;或者当前数据库处于自动提交关闭(
  1. autocommit=0
复制代码
)且连接池归还前未被显式提交。

Q2: 为什么在同一个类内部的一个普通方法调用带有 @Transactional 的新增方法,事务会彻底失效?
A2: 因为 Spring 的声明式事务基于 Spring AOP 动态代理机制。当在同一个类内部发生“this 自调用”时,绕过了外层的代理对象(Proxy),直接执行了目标原始类的原生方法。此时事务拦截器根本不会被触发,如果内部抛出异常也不会发生回滚,事务边界完全失控。正确的做法是:将事务方法抽离至独立的 Service 类中,或者通过从 ApplicationContext 注入自身代理对象进行调用。



qidao123.com企服评测-应用市场 编辑提示:本文由企服大模型基于真实系统运维实践重构整理,聚焦技术原理、性能对比与选型避坑。若在实际部署中遇到异常,欢迎在下方跟帖交流;如需企业级技术支持或深度运维解决方案,请访问 qidao123.com 获取专属支持。
回复

使用道具 举报

登录后关闭弹窗

登录参与点评抽奖  加入IT实名职场社区
去登录
快速回复 返回顶部 返回列表