Quarkus PubSub消息处理时ReactiveTransactional触发Session空指针异常排查

• 确认MongoDB环境支持事务
  MongoDB仅在副本集或分片集群模式下支持事务，单节点默认禁用事务功能。如果你的MongoDB是单节点部署，@ReactiveTransactional无法获取到合法的事务会话，直接导致session为null。需要切换到副本集模式，或者确认当前MongoDB集群的事务功能已启用。

• 检查依赖配置完整性
  确保项目pom.xml（或build.gradle）中包含了正确的依赖：

  • quarkus-mongodb-panache-reactive：Reactive Panache操作MongoDB的核心依赖
  • quarkus-mongodb-reactive：MongoDB reactive驱动依赖
    避免遗漏或依赖版本不匹配，需保证Quarkus版本与依赖版本保持一致。

• 验证Quarkus事务相关配置
  在application.properties中确认以下配置：

  • 连接字符串需指定副本集（如果是副本集模式）：quarkus.mongodb.connection-string=mongodb://host1:27017,host2:27017/db?replicaSet=rs0
  • 启用MongoDB事务支持：quarkus.mongodb.transaction.enabled=true
    错误的连接配置会导致无法创建事务会话，进而出现session null的问题。

• 检查消息处理方法的合规性

  • 方法所在类必须是CDI托管Bean（比如添加@ApplicationScoped、@Singleton注解），否则事务拦截器无法生效。
  • 方法返回值必须为Mutiny的Uni<Void>或其他Uni类型，不能是void。@ReactiveTransactional需要通过Uni的链式调用管理事务上下文，返回void会导致事务上下文无法正确初始化。

• 排查上下文激活问题
  部分消息驱动场景下，CDI上下文可能未自动激活。可以尝试在方法上添加@ActivateRequestContext注解，强制激活请求上下文，确保事务拦截器能获取到所需的session实例。

• 检查拦截器执行顺序
  如果项目中存在自定义拦截器，确认它们的执行顺序不会干扰事务拦截器。比如自定义拦截器不要过早终止方法执行，或者覆盖了事务拦截器的上下文初始化逻辑。

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