从‘查不到数据’到‘自动流转’：手把手调试RuoYi-Flowable动态审批人逻辑（附完整测试类写法）
从‘查不到数据’到‘自动流转’：RuoYi-Flowable动态审批人全流程调试指南
1. 问题定位与调试环境搭建
当你在RuoYi-Flowable项目中实现动态审批人功能时，最令人头疼的莫过于流程表达式配置正确但运行时却返回null或报错。这种情况往往源于三个关键环节的配置问题：
典型报错场景分析：
Unknown property used in expression：服务类未被Spring容器正确识别NullPointerException：MyBatis查询结果封装失败No such method：流程表达式调用方法签名不匹配
提示：调试前请确保已安装Lombok插件，否则部分代码可能无法正常编译
我们先搭建一个最小化的测试环境。在src/test/java下创建测试类结构：
@SpringBootTest @RunWith(SpringRunner.class) public class FlowableDynamicAssigneeTest { @Autowired private ISysUserService userService; @Autowired private RuntimeService runtimeService; }注意测试类必须与主启动类在相同包路径下，否则需要显式指定启动类：
@SpringBootTest(classes = RuoYiApplication.class)2. Service层单元测试实战
2.1 解决MyBatis结果封装为null的问题
当selectDirectLeaderByPostCode方法始终返回null时，首先检查Mapper层结果映射。以下是两种解决方案的对比：
| 方案 | 配置方式 | 优点 | 缺点 |
|---|---|---|---|
| 全局配置 | 在application.yml中添加mybatis.configuration.map-underscore-to-camel-case=true | 一次性解决所有映射问题 | 无法处理复杂映射关系 |
| XML映射 | 在Mapper.xml中定义<resultMap> | 可精确控制每个字段映射 | 需要为每个查询单独配置 |
推荐使用XML映射方案，示例：
<resultMap id="UserResult" type="com.ruoyi.system.domain.SysUser"> <id property="userId" column="user_id" /> <result property="deptId" column="dept_id" /> <result property="userName" column="user_name" /> </resultMap> <select id="selectUsersByDeptId" resultMap="UserResult"> SELECT * FROM sys_user WHERE dept_id = #{deptId} </select>2.2 循环依赖问题破解
若测试时遇到Circular dependency警告，可通过以下方式解决：
- 将测试类移到admin模块（主模块）下
- 使用
@Lazy注解延迟加载依赖 - 重构代码消除循环引用
推荐方案1，这是最彻底的解决方案。
3. 流程表达式深度解析
3.1 两种动态审批人实现方式对比
固定变量方式：
variables.put("headTeacherId", 12345);BPMN配置：
<formalExpression>${headTeacherId}</formalExpression>动态查询方式：
<formalExpression>${userService.getHeadTeacher(execution.getVariable('initiator'))}</formalExpression>性能与灵活性对比：
| 维度 | 固定变量 | 动态查询 |
|---|---|---|
| 执行效率 | ★★★★☆ | ★★☆☆☆ |
| 实时性 | ★☆☆☆☆ | ★★★★☆ |
| 配置复杂度 | ★★☆☆☆ | ★★★★☆ |
| 维护成本 | ★★☆☆☆ | ★★★☆☆ |
3.2 表达式服务注册机制
要使流程引擎识别自定义Service，必须确保：
- 类上有
@Service注解 - 首字母小写的bean名称与表达式中的引用一致
- 在Flowable配置中显式注册：
@Configuration public class FlowableConfig { @Bean public SpringProcessEngineConfiguration springProcessEngineConfiguration( UserService userService) { SpringProcessEngineConfiguration config = new SpringProcessEngineConfiguration(); config.getBeans().put("userService", userService); return config; } }常见错误排查清单：
- 检查@Service注解的value是否与表达式中的名称一致
- 确认方法访问权限为public
- 验证方法参数类型与流程变量类型匹配
4. 完整测试类编写指南
4.1 集成测试示例
@Test public void testDynamicApprovalFlow() { // 1. 准备测试数据 Long studentId = 123L; String processDefinitionKey = "leaveApproval"; // 2. 设置流程变量 Map<String, Object> variables = new HashMap<>(); variables.put("initiator", studentId); // 3. 启动流程实例 ProcessInstance instance = runtimeService.startProcessInstanceByKey( processDefinitionKey, variables); // 4. 验证任务分配 Task task = taskService.createTaskQuery() .processInstanceId(instance.getId()) .singleResult(); Long expectedTeacherId = userService.selectDirectLeaderByPostCode( studentId, "class_teacher"); assertEquals(expectedTeacherId.toString(), task.getAssignee()); }4.2 测试数据准备技巧
使用@Sql注解初始化测试数据：
@Test @Sql(scripts = "/sql/init_teacher_student.sql") public void testWithRealData() { // 测试逻辑 }init_teacher_student.sql示例：
INSERT INTO sys_dept VALUES(1, '计算机学院', 0, '001'); INSERT INTO sys_user VALUES(100, 1, '张老师', 'teacher'); INSERT INTO sys_user VALUES(101, 1, '李同学', 'student'); INSERT INTO sys_user_post VALUES(100, 1); -- 班主任岗位5. 生产环境优化建议
性能优化：
- 为
dept_id和post_code字段添加索引 - 考虑缓存班主任信息，减少数据库查询
- 批量查询替代循环中的单条查询
- 为
健壮性增强：
public Long selectDirectLeaderByPostCode(Long userId, String postCode) { List<SysUser> users = this.selectDeptUsersByUserId(userId); if(CollectionUtils.isEmpty(users)) { throw new BusinessException("部门下没有用户"); } return users.stream() .filter(u -> this.checkIncludePostCode( postMapper.selectPostCodeListByUserId(u.getUserId()), postCode)) .findFirst() .orElseThrow(() -> new BusinessException("未找到指定岗位负责人")) .getUserId(); }事务管理：
@Transactional(rollbackFor = Exception.class) public Long assignHeadTeacher(Long deptId, Long userId) { // 先解除原班主任关联 postMapper.deleteByDeptAndPost(deptId, "class_teacher"); // 设置新班主任 return postMapper.insertUserPost(userId, "class_teacher"); }
在调试过程中，记得充分利用Flowable的调试日志：
# application.yml logging.level.org.flowable=DEBUG当看到控制台输出流程变量和SQL语句时，就像拥有了X光透视能力，可以清晰看到整个审批流转的内部运作机制。