ThreadLocal用于确保同一请求线程内所有Service方法共享唯一数据库连接，避免多连接导致事务不一致；其核心是线程绑定、复用与及时remove清理，支撑事务传播与ACID保障。
在自定义事务管理器中，用 ThreadLocal 让 Service 层嵌套调用共享同一个数据库连接，核心是：**每个线程独占一个连接，且在整个事务生命周期内复用它，避免嵌套方法重复获取新连接或提交/回滚冲突**。
为什么需要 ThreadLocal？
Java Web 应用中，一个 HTTP 请求通常由单个线程处理。Service 方法 A 调用 B，B 调用 C，若每次调用都新建 Connection，会导致：
- 多个连接各自开启事务，无法统一提交或回滚（违反 ACID）
- 连接未关闭或提前关闭，引发资源泄漏或 SQLException
- 事务传播行为（如 REQUIRED）失效
ThreadLocal<Connection> 正好解决这个问题：它为当前线程绑定唯一连接，子方法无需传参即可访问同一实例。
如何实现连接的绑定与解绑？
在自定义事务管理器中，定义静态 ThreadLocal 并配套管理方法：
立即学习“Java免费学习笔记（深入）”；
Customer Service Reply
下载
客服回复模板。售前咨询、售后处理、退换货、投诉回复、好评引导、升级处理、行业FAQ、满意度挽回。Customer service reply templates for pre-sale, after-sale, returns, complaints, escalation, FAQ generation, s...
private static final ThreadLocal<Connection> CONNECTION_HOLDER = ThreadLocal.withInitial(() -> null);
public static Connection getCurrentConnection() {
return CONNECTION_HOLDER.get();
}
public static void bindConnection(Connection conn) {
CONNECTION_HOLDER.set(conn);
}
public static void unbindConnection() {
CONNECTION_HOLDER.remove(); // 必须调用 remove()，避免线程复用（如 Tomcat 线程池）导致脏数据
}
注意：不要只设为 null，必须调用 remove()，否则线程被容器复用时可能残留上一次请求的连接。
事务开启、挂起与恢复怎么配合 ThreadLocal？
当 Service 方法声明 @Transactional(propagation = Propagation.REQUIRED)，嵌套调用时需支持“已有事务则加入”：
- 外层方法开启事务 → 获取新连接，
bindConnection(conn) - 内层方法检测到
getCurrentConnection() != null→ 直接复用，不新建连接 - 若内层是
REQUIRES_NEW，则需先unbind()保存旧连接，再创建新连接并绑定；事务结束再恢复旧连接
此时建议用 ThreadLocal<Stack<Connection>> 或封装一个上下文对象（如 TransactionContext）来支持嵌套事务的挂起/恢复，而不仅是单个连接。
实际使用中的关键细节
确保以下几点才能真正生效：
- Connection 必须来自同一个 DataSource（不能混用不同数据源的连接）
-
手动控制事务时，Connection 的 autoCommit 必须设为 false：
conn.setAutoCommit(false) - 务必在 finally 块或 try-with-resources 后正确 unbind，推荐放在 AOP 的 afterReturning / afterThrowing / afterAdvice 中统一清理
- 避免在异步线程（如 @Async、new Thread）中调用事务方法 —— ThreadLocal 不会自动传递，需显式拷贝
不复杂但容易忽略。
