配置动态数据源的核心在于实现一个继承自 abstractroutingdatasource 的类,并重写 determinecurrentlookupkey() 方法以根据当前线程上下文返回目标数据源的键。在 spring boot 中,通常结合 threadlocal 或 transmittablethreadlocal 来管理多租户或业务场景下的数据源切换逻辑,确保每个请求能正确路由到对应的数据库实例。

如何设计支持多数据源的路由策略
设计路由策略的关键是维护一个全局的 Map 用于存储所有可用的数据源实例,并通过一个静态工具类提供设置和获取当前数据源键的方法。当应用启动时,将所有配置好的数据源注册到路由器的目标映射表中;在运行时,通过拦截器或 AOP 切面解析请求中的租户 ID 或业务标识,将其存入 ThreadLocal,从而让路由器在每次查询时都能动态决定使用哪个连接池。

import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;
public class DynamicDataSource extends AbstractRoutingDataSource {
@Override
protected Object determineCurrentLookupKey() {
return DataSourceContextHolder.getDataSourceType();
}
}
上述代码展示了最核心的路由类实现。它没有硬编码任何数据源选择逻辑,而是完全依赖于 DataSourceContextHolder 提供的当前线程上下文。这种解耦方式使得业务代码无需关心底层连接的是哪个库,只需关注业务逻辑本身。在实际部署中,你需要确保 targetDataSources 属性在 Spring 配置中被正确注入,否则路由器将无法找到具体的数据源实例。
如何在多线程环境下安全地切换数据源
在微服务或高并发场景中,直接使用普通的 ThreadLocal 可能会导致线程池复用时的数据污染问题,即前一个任务的数据源键残留并影响后续任务。为了解决这个问题,应引入阿里巴巴开源的 TransmittableThreadLocal (TTL) 库,或者在提交线程任务前手动捕获并传递上下文状态。这样可以保证数据源切换操作具有原子性和隔离性,避免跨线程的数据错乱。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import com.alibaba.ttl.TransmittableThreadLocal;
public class DataSourceContextHolder {
private static final TransmittableThreadLocal<string> CONTEXT_HOLDER = new TransmittableThreadLocal();
public static void setDataSourceType(String type) {
CONTEXT_HOLDER.set(type);
}
public static String getDataSourceType() {
return CONTEXT_HOLDER.get();
}
public static void clear() {
CONTEXT_HOLDER.remove();
}
}</string>
这段代码定义了基于 TTL 的上下文持有者。与标准 ThreadLocal 不同,TTL 会在任务提交到线程池时自动复制当前的上下文值到子任务中,并在任务结束后清理,从而完美适配异步执行和多线程环境。开发者在使用时,务必在 @AfterCompletion 或 @Finally 阶段调用 clear() 方法,防止内存泄漏或状态残留。
当数据源键不存在时会发生什么
如果 determineCurrentLookupKey() 返回了一个未在 targetDataSources 中注册的键,Spring 框架会抛出 IllegalStateException,提示无法确定目标数据源。这通常发生在租户 ID 配置错误或上下文未正确初始化时。为了避免应用崩溃,建议在路由器的 determineCurrentLookupKey() 方法中加入默认值回退逻辑,例如当找不到特定租户数据源时,默认返回主库(Master)的数据源键,以确保系统具备基本的容错能力。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










