Spring AbstractRoutingDataSource能否无默认DataSource运行？启动报错求助

问题根源 #

Spring启动阶段会触发数据源的初始化校验（比如数据库健康检查、ORM框架初始化、事务管理器初始化），此时租户上下文尚未加载，determineCurrentLookupKey()返回null，而你未设置默认DataSource，就会抛出Cannot determine target DataSource for lookup key [null]异常。

解决办法 #

1. 重写determineTargetDataSource适配启动阶段的null场景 #

在自定义的RoutingDataSource中重写该方法，当lookupKey为null时返回一个临时的空数据源（比如嵌入式H2数据库，或自定义无操作数据源），仅用于通过启动校验，业务运行时不会用到。

示例代码（用H2临时数据源）：

public class TenantRoutingDataSource extends AbstractRoutingDataSource {

    @Override
    protected DataSource determineTargetDataSource() {
        Object lookupKey = determineCurrentLookupKey();
        if (lookupKey == null) {
            // 返回启动用的临时嵌入式数据源
            return new EmbeddedDatabaseBuilder()
                    .setType(EmbeddedDatabaseType.H2)
                    .build();
        }
        return super.determineTargetDataSource();
    }

    @Override
    protected Object determineCurrentLookupKey() {
        return TenantContext.getCurrentTenantId();
    }
}

如果不想依赖H2，可自定义无操作DataSource：

public class NoOpDataSource implements DataSource {
    @Override
    public Connection getConnection() throws SQLException {
        // 启动阶段一般不会实际调用该方法，若调用则抛出明确异常
        throw new SQLException("Tenant context not initialized yet, this is a bootstrap-only data source");
    }

    @Override
    public Connection getConnection(String username, String password) throws SQLException {
        return getConnection();
    }

    // 实现剩余接口方法，默认返回空或抛出不支持异常即可
    @Override
    public <T> T unwrap(Class<T> iface) throws SQLException {
        throw new SQLException("Unsupported operation");
    }

    @Override
    public boolean isWrapperFor(Class<?> iface) throws SQLException {
        return false;
    }

    @Override
    public Logger getParentLogger() throws SQLFeatureNotSupportedException {
        throw new SQLFeatureNotSupportedException();
    }
}

然后在determineTargetDataSource中返回new NoOpDataSource()即可。

2. 禁用或延迟启动阶段的数据源校验 #

如果使用Spring Boot，可通过配置跳过启动时的数据源健康检查，或延迟初始化相关Bean：

• 关闭数据源健康检查：在application.properties中添加

  management.health.db.enabled=false
  

• 延迟初始化数据源相关Bean：在启动类上添加@Lazy，或针对DataSource、EntityManagerFactory等Bean单独标记@Lazy，让这些Bean在首次实际业务调用时才初始化，避免启动阶段触发数据源校验。

3. 提前设置启动用的临时租户Key #

在Spring启动早期，通过事件监听器设置一个临时租户Key，并在数据源映射中提前注册该Key对应的临时数据源，启动完成后清除该临时Key。

示例代码：

// 启动时设置临时租户Key
@Component
public class BootstrapTenantListener implements ApplicationListener<ApplicationStartingEvent> {
    @Override
    public void onApplicationEvent(ApplicationStartingEvent event) {
        TenantContext.setCurrentTenantId("bootstrap-tenant");
    }
}

// 启动完成后清除临时租户Key
@Component
public class CleanupBootstrapTenantListener implements ApplicationListener<ContextRefreshedEvent> {
    @Override
    public void onApplicationEvent(ContextRefreshedEvent event) {
        TenantContext.clearCurrentTenantId();
    }
}

同时在初始化TenantRoutingDataSource时，将"bootstrap-tenant"对应的临时数据源（如H2）加入targetDataSources。

内容的提问来源于stack exchange，提问作者Nikki Nicholas Romero