Spring Boot WebFlux整合R2DBC/JDBC时接口404与仓储识别异常排查
问题根因与修复方案
核心故障链路
项目同时引入JDBC、R2DBC两套关系型Spring Data模块,触发框架的严格仓储解析模式,直接引发连锁异常:
- 框架无法明确区分仓储接口的归属模块,跳过所有R2DBC仓储接口的扫描注册,最终容器内R2DBC仓储Bean数量为0
- 仓储Bean缺失的场景下,服务启动过程因Spring Data的宽松校验逻辑不会抛出致命异常,仅打印WARN级别的提示日志,造成“启动完全正常”的假象
- 如果Controller所在包未被组件扫描覆盖,Netty服务启动后不会注册任何REST接口路径,请求抵达后自然返回404
具体修复操作
- 隔离两套仓储的扫描范围
- 修改
@EnableR2dbcRepositories配置,明确指定R2DBC仓储的扫描包路径,不要依赖框架的自动包扫描逻辑,示例配置:@EnableR2dbcRepositories(basePackages = "你的项目根包.repository.r2dbc") - 把R2DBC仓储、JDBC仓储拆分到独立的子包下,避免两个扫描器重复扫描同一批接口,从根源上消除类型识别歧义
- 修改
- 修正实体类的映射注解
按照启动日志的提示,给所有需要R2DBC映射的实体类标注org.springframework.data.relational.core.mapping.Table注解,不要使用已废弃的旧版R2DBC专属表注解,满足严格模式的识别要求 - 排查Controller扫描配置
确认启动类上@ComponentScan指定的包路径覆盖了Controller、Service所在的层级。WebFlux模式下,只有被Spring容器管理的Controller才会被注册接口路由,未被扫描到的Controller即使注解正确,也不会对外暴露访问路径 - 调整不合理的R2DBC连接池参数
当前配置的初始连接100、最大连接500的参数远超常规REST服务的需求,建议调整为初始连接10、最大连接50,避免启动时占用过多数据库连接资源
正常逻辑说明
Liquibase依赖JDBC连接执行数据库变更脚本是合理的,脚本执行完成后Hikari连接池自动释放的行为属于正常逻辑,不需要额外调整。
内容的提问来源于stack exchange,提问作者Zaur Farrukzada
相关产品推荐
相关产品推荐

