JeecgBoot多数据源环境下Excel导入字典翻译问题解析

问题背景

在JeecgBoot 3.8版本中，当系统配置了多数据源环境时，使用ExcelImportUtil.importExcel()方法进行Excel导入操作，并通过@Excel注解的dictcode属性实现字典翻译功能时，会出现"对象名'sys_dict_item'无效"的错误。这个问题主要发生在数据源切换过程中，导致系统无法正确访问字典表。

问题本质

该问题的核心在于JeecgBoot在多数据源环境下处理Excel导入时的数据源切换逻辑存在缺陷。具体表现为：

1. 虽然业务代码中显式地通过DynamicDataSourceContextHolder.push(MASTER)设置了主数据源
2. 但在执行字典翻译时，系统内部又自动切换到了业务数据源
3. 导致在业务数据库中找不到系统字典表(sys_dict和sys_dict_item)

技术原理分析

JeecgBoot的Excel导入功能通过以下机制实现字典翻译：

1. @Excel注解的dictcode属性指定了字典编码
2. ExcelImportUtil在导入过程中会自动调用SysDictServiceImpl.queryDictItemsByCode()方法
3. 该方法会查询sys_dict和sys_dict_item表获取字典项

在多数据源环境下，问题出在：

1. 数据源切换机制(DynamicDataSourceContextHolder)采用栈结构管理
2. 某些AOP拦截器或MyBatis拦截器可能在执行过程中修改了当前数据源
3. 字典查询操作没有强制使用系统数据源

解决方案

针对这个问题，可以从以下几个层面解决：

方案一：强制字典查询使用系统数据源

修改SysDictServiceImpl.queryDictItemsByCode()方法，在方法内部强制使用系统数据源：

public List<DictModel> queryDictItemsByCode(String code) {
    try {
        DynamicDataSourceContextHolder.push(DataSourceCommonConstant.SYS_DATA_SOURCE);
        return sysDictMapper.queryDictItemsByCode(code);
    } finally {
        DynamicDataSourceContextHolder.poll();
    }
}

方案二：修改Excel导入的数据源管理策略

重构ExcelImportUtil，确保在整个导入过程中保持数据源一致性：

try {
    DynamicDataSourceContextHolder.push(MASTER);
    // 执行导入前设置线程变量，标识当前在导入流程中
    ImportContext.setImporting(true);
    list = ExcelImportUtil.importExcel(inputStream, entityClass, params);
} finally {
    ImportContext.clear();
    DynamicDataSourceContextHolder.poll();
}

方案三：配置多数据源路由规则

在数据源路由配置中，为系统表访问强制指定数据源：

jeecg:
  datasource:
    dynamic:
      strategy:
        system-tables: master
        system-tables-include: sys_dict,sys_dict_item

最佳实践建议

1. 在多数据源环境中，系统表(如字典表)应该统一存放在主数据源中
2. 对于系统基础功能的访问，应该显式指定数据源
3. 考虑使用ThreadLocal变量跟踪数据源切换上下文
4. 在事务边界处做好数据源清理工作
5. 对于Excel导入等批量操作，建议全程使用单一数据源

总结

JeecgBoot在多数据源环境下处理Excel导入时的字典翻译问题，本质上是数据源上下文管理的问题。通过分析我们可以看出，在复杂业务场景中，数据源切换需要更加精细的控制。开发者在使用多数据源功能时，应当特别注意系统基础功能与业务功能之间的数据源隔离问题，确保关键系统表始终可访问。