Docker环境下Activiti 7.x集成Kafka报错，求配置排查

常见配置问题及解决方法 #

• 事务ID重复冲突
  报错信息TransactionalId tx-0: Invalid transition attempted from state IN_TRANSACTION to state IN_TRANSACTION的核心原因是Kafka事务ID重复。Activiti 7.x各组件（runtime bundle、query bundle等）如果共用同一个事务ID前缀，会导致多个实例生成重复的事务ID，触发状态冲突。
  • 检查Docker Compose中各Activiti组件的spring.cloud.stream.kafka.binder.transaction.transaction-id-prefix配置，给每个组件设置唯一前缀，比如runtime bundle设为rt-bundle-tx-，query bundle设为q-bundle-tx-，避免ID重复。
• Kafka Broker事务配置未启用
  若Kafka服务未开启事务支持，会导致事务状态流转异常。
  • 在Docker Compose的Kafka服务配置中，添加以下参数：

    environment:
      - KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR=1
      - KAFKA_TRANSACTION_STATE_LOG_MIN_ISR=1
    

    单节点环境下这两个参数设为1即可启用事务日志功能。
• 多消息中间件配置残留
  切换到Kafka时，若未完全清理RabbitMQ相关配置，会引发事务管理冲突。
  • 确保Docker Compose中所有Activiti组件的配置里，移除所有spring.cloud.stream.rabbit.*相关参数，避免双中间件配置干扰。
• 事务管理器配置冲突
  Activiti同时使用SQL Server的JDBC事务和Kafka事务时，可能出现状态冲突。
  • 若无需分布式XA事务，可在Activiti组件配置中添加spring.cloud.stream.kafka.binder.transaction.producer-only-transactions=true，仅启用生产者事务，简化事务模型。

额外排查方向 #

• 确认构建镜像时添加SQL Server驱动的操作，未误修改或引入冲突的事务管理依赖。
• 检查Docker Compose中各Activiti组件的spring.application.name是否唯一，部分场景下事务ID前缀会默认关联应用名，重复名称也会导致ID冲突。

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