SpringBoot定时任务报错：无法确定查找键null对应的目标数据源

这个错误的核心原因是：定时任务的执行线程不属于业务请求线程池，没有经过你平时业务流程中设置数据源路由key的逻辑（比如拦截器、AOP），导致CustomRoutingDataSource找不到有效的lookup key，最终抛出异常。以下是具体解决办法：

1. 给路由数据源配置默认 fallback 数据源 #

在主类定义CustomRoutingDataSource的@Bean方法中，设置默认目标数据源，当lookup key为null时自动使用这个默认数据源，避免报错。

示例代码：

@Bean
public DataSource routingDataSource(DataSource primaryDataSource, DataSource secondaryDataSource) {
    CustomRoutingDataSource dataSource = new CustomRoutingDataSource();
    
    // 配置可用的数据源映射
    Map<Object, Object> targetDataSources = new HashMap<>();
    targetDataSources.put("primary", primaryDataSource);
    targetDataSources.put("secondary", secondaryDataSource);
    dataSource.setTargetDataSources(targetDataSources);
    
    // 设置默认数据源，解决key为null的场景
    dataSource.setDefaultTargetDataSource(primaryDataSource);
    
    return dataSource;
}

2. 在定时任务方法中显式设置并清理数据源key #

如果需要指定定时任务使用特定数据源，而不是默认数据源，可以在定时任务方法中手动设置线程上下文的数据源key，执行完成后务必清理，防止线程复用导致后续任务数据源混乱。

首先确保你有管理线程上下文的工具类：

public class DataSourceContextHolder {
    private static final ThreadLocal<String> DATA_SOURCE_KEY = new ThreadLocal<>();

    public static void setDataSourceKey(String key) {
        DATA_SOURCE_KEY.set(key);
    }

    public static String getDataSourceKey() {
        return DATA_SOURCE_KEY.get();
    }

    public static void clearDataSourceKey() {
        DATA_SOURCE_KEY.remove();
    }
}

然后在定时任务方法中使用：

@Service
@EnableScheduling
public class ScheduledDbService {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    @Scheduled(cron = "0 0/5 * * * ?")
    public void executeScheduledQuery() {
        try {
            // 显式设置要使用的数据源key
            DataSourceContextHolder.setDataSourceKey("secondary");
            // 执行数据库操作
            Integer count = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM user", Integer.class);
            System.out.println("定时任务查询用户数量：" + count);
        } finally {
            // 必须清理线程上下文的key
            DataSourceContextHolder.clearDataSourceKey();
        }
    }
}

3. 验证路由数据源的key获取逻辑 #

确保CustomRoutingDataSource的determineCurrentLookupKey方法正确从线程上下文获取key：

public class CustomRoutingDataSource extends AbstractRoutingDataSource {
    @Override
    protected Object determineCurrentLookupKey() {
        // 从上下文获取key，和上面的工具类对应
        return DataSourceContextHolder.getDataSourceKey();
    }
}

4. 避免直接注入具体数据源 #

不要在定时任务中直接注入primaryDataSource或secondaryDataSource，应该注入JdbcTemplate、EntityManager等上层操作类，它们会自动使用你配置的路由数据源，绕开路由逻辑直接用具体数据源会导致路由失效。

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