Activiti边界事件在Spring Boot集成测试中未触发的问题咨询

嘿，针对你遇到的Activiti边界事件在集成测试里的问题，我来分享几个常见的排查方向和解决方案，毕竟我之前也踩过类似的坑～

你提到正常运行Spring Boot应用时边界事件都能正常触发，但在带@Transactional的集成测试里出问题，核心矛盾基本都和事务时机、Activiti引擎运行环境有关，咱们一步步拆解：

1. 事务未提交导致Activiti无法感知事件状态 #

Spring测试的@Transactional注解会把整个测试方法包裹在一个未提交的事务里，直到方法执行完毕才会提交（默认还会回滚）。但Activiti的流程引擎是依赖数据库的状态变更来驱动事件的：

• 你在测试里启动流程、触发信号/消息的操作，都停留在未提交的事务快照里
• Activiti的事件监听器、异步执行器根本读取不到这些未提交的数据，自然无法触发边界事件

解决方案：
手动控制事务边界，在触发事件前提交事务，让Activiti能读取到流程状态：

@Autowired
private PlatformTransactionManager transactionManager;

@Test
public void testBoundarySignalEvent() {
    // 1. 启动流程，走到绑定边界事件的节点
    ProcessInstance instance = runtimeService.startProcessInstanceByKey("test-process");
    
    // 2. 手动提交事务，让Activiti感知到流程状态
    TransactionStatus status = transactionManager.getTransaction(new DefaultTransactionDefinition());
    transactionManager.commit(status);
    
    // 3. 触发对应的事件（比如发送信号）
    runtimeService.signalEventReceived("test-signal", instance.getId());
    
    // 4. 等待事件执行（可以用Thread.sleep或者更优雅的轮询断言）
    Thread.sleep(1000);
    
    // 5. 断言边界事件执行后的结果
    Task task = taskService.createTaskQuery().processInstanceId(instance.getId()).singleResult();
    assertEquals("after-boundary-task", task.getTaskDefinitionKey());
}

也可以给测试方法加@Rollback(false)跳过默认回滚，但要注意测试后清理数据库数据。

2. 异步执行器未启动（针对定时器/异步边界事件） #

Activiti的定时器边界事件、异步边界事件依赖内置的异步执行器来调度，但默认情况下，集成测试环境里异步执行器可能没有激活。

解决方案：
在测试环境配置文件（application-it.properties）中开启异步执行器：

# 启用异步执行器
spring.activiti.async-executor.enabled=true
# 启动时激活执行器
spring.activiti.async-executor.activate=true
# 缩短轮询间隔，方便测试快速看到结果
spring.activiti.async-executor.default-job-acquire-wait-time=500

3. 流程未走到绑定边界事件的节点 #

有时候测试里的流程可能因为分支判断、前置任务未完成等原因，根本没到达绑定边界事件的节点，自然触发不了事件。

验证小技巧：
在测试中打印流程当前执行的节点，确认流程状态：

ProcessInstance instance = runtimeService.startProcessInstanceByKey("test-process");
List<Execution> executions = runtimeService.createExecutionQuery()
        .processInstanceId(instance.getId())
        .list();
executions.forEach(exec -> System.out.println("当前执行节点ID：" + exec.getActivityId()));

确认流程确实停留在绑定了边界事件的节点后，再触发对应的事件。

4. 事务回滚覆盖了事件执行结果 #

如果测试方法默认回滚，即使边界事件已经执行，测试结束后事务回滚会把事件执行的数据库变更（比如任务创建、流程状态更新）全部撤销，导致你看不到预期结果。

解决方案：

• 用@Rollback(false)禁用回滚，测试后手动清理数据（比如用@After方法删除流程实例）
• 或者使用嵌入式数据库（如H2），测试结束后自动清空数据，无需手动清理

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