Spring WebFlux 3.3.2中@Transactional注解失效问题求助

核心原因分析及排查方向 #

1. 事务注解的兼容性冲突 #

Spring WebFlux 3.x全面迁移到Jakarta EE规范，但jakarta.transaction.Transactional是JTA注解，更适配传统JDBC或分布式事务场景；而Reactive单库事务优先适配Spring原生的org.springframework.transaction.annotation.Transactional。混用JTA注解和Spring Reactive事务管理器，会导致事务上下文无法正确绑定，进而触发线程阻塞或上下文丢失，最终引发Socket Hang Up（请求超时断开）。

• 排查：换回org.springframework.transaction.annotation.Transactional，确保和R2dbcTransactionManager配对使用。

2. R2DBC事务管理器配置不完整 #

R2dbcTransactionManager必须正确关联R2DBC连接工厂（ConnectionFactory Bean），如果配置时未注入连接工厂，事务管理器无法获取数据库连接，会导致事务初始化卡住，请求挂起直到超时。

• 排查：检查R2dbcTransactionManager Bean的注入逻辑是否正确：

@Bean
public R2dbcTransactionManager transactionManager(ConnectionFactory connectionFactory) {
    return new R2dbcTransactionManager(connectionFactory);
}

同时确认ConnectionFactory本身能正常连接数据库。

3. Reactive流中存在阻塞操作 #

WebFlux是异步非阻塞模型，若@Transactional服务方法内有阻塞调用（比如block()、传统JDBC操作、同步IO），会占用事件循环线程，导致请求处理停滞，触发Socket Hang Up。Spring 3.x对阻塞操作的检测更严格，直接导致线程挂起的概率更高。

• 排查：替换所有同步阻塞代码为Reactive API（比如R2DBC的Mono/Flux操作，避免block()）。可通过blockhound检测阻塞点：

<dependency>
    <groupId>io.projectreactor.tools</groupId>
    <artifactId>blockhound</artifactId>
    <version>1.0.8.RELEASE</version>
    <scope>test</scope>
</dependency>

启动时初始化BlockHound：

BlockHound.install();

4. 事务上下文传播配置错误 #

Reactive事务的传播行为和传统事务存在差异，若控制器方法返回Mono/Flux，但服务层事务方法的返回类型或传播配置不匹配，会导致事务上下文无法正确传递，请求处理中断。

• 排查：确保服务层方法返回Mono/Flux类型，使用Reactive支持的传播行为（默认PROPAGATION_REQUIRED即可），避免使用JTA特有的传播规则。

5. 日志配置未覆盖关键路径 #

仅开启org.springframework.transaction的DEBUG日志不足以定位问题，Socket Hang Up可能和数据库连接、Reactor线程池、请求超时有关，需补充以下日志：

• io.r2dbc：查看R2DBC连接和事务的具体交互
• reactor.netty：排查Netty线程池状态和连接超时
• org.springframework.web.reactive：跟踪请求在WebFlux链路中的流转

快速验证步骤 #

1. 暂时移除@Transactional注解，测试服务方法是否能正常响应，排除事务之外的问题。
2. 将服务层方法简化为简单Reactive操作（比如返回Mono.just("test")），加上@Transactional测试是否能正常执行，定位是否是事务逻辑本身的问题。
3. 检查项目中是否存在旧版本Spring事务相关依赖（比如spring-tx），确保所有依赖都升级到3.3.2版本，避免依赖冲突。

内容的提问来源于stack exchange，提问作者Gopal Aggarwal