ThreadLocal用于为每个线程绑定独立Connection以避免线程不安全和频繁创建开销，但需手动管理获取、使用与关闭，否则易致连接泄漏。
在多线程环境中，ThreadLocal 常被用来为每个线程单独维护一个数据库连接（如 Connection），避免连接被多个线程共享导致线程不安全，也省去频繁创建/关闭连接的开销。但要注意：它只是“绑定”，不是“自动管理”——连接的获取、使用、关闭仍需手动控制，否则极易造成连接泄漏。
为什么用 ThreadLocal 绑定 Connection？
数据库连接（java.sql.Connection）默认不是线程安全的。如果多个线程共用一个连接执行事务、设置 auto-commit、调用 close() 等操作，行为不可预测，甚至抛出异常。而每次请求都新建连接又太重。用 ThreadLocal<Connection> 可以让每个线程拥有自己的连接实例，天然隔离，适合单次请求生命周期（如 Web 请求线程）。
基本用法：初始化、获取、清理
典型模式是在线程开始时获取连接，使用完毕后显式关闭并清空 ThreadLocal：
-
声明 ThreadLocal：建议用
static final，并重写initialValue()懒加载连接 -
获取连接：调用
tl.get()，首次会触发初始化 -
务必清理：在 finally 块中调用
tl.remove()，防止线程复用（如 Tomcat 线程池）导致旧连接残留和内存泄漏
示例代码：
立即学习“Java免费学习笔记（深入）”；
private static final ThreadLocal<Connection> CONNECTION_HOLDER = ThreadLocal.withInitial(() -> {
try {
return DriverManager.getConnection("jdbc:h2:mem:test", "sa", "");
} catch (SQLException e) {
throw new RuntimeException(e);
}
});
public static Connection getConnection() {
return CONNECTION_HOLDER.get();
}
public static void closeConnection() {
Connection conn = CONNECTION_HOLDER.get();
if (conn != null) {
try {
conn.close();
} catch (SQLException ignored) {}
}
CONNECTION_HOLDER.remove(); // 关键：必须 remove
}
实际场景中的注意事项
-
不要在异步线程中直接继承：子线程不会自动获得父线程的
ThreadLocal值。如用CompletableFuture或线程池提交任务，需手动传递或重新绑定 -
Web 应用要配合请求生命周期：通常在 Filter 的
doFilter()开头获取连接，finally中关闭并remove()；避免在 Service 层随意调用get()而不保证清理 -
连接泄漏比想象中更容易发生：比如某个分支抛异常未走到
closeConnection()，或忘记remove()。建议结合 try-with-resources + 显式 remove，或封装成模板方法
更安全的替代思路
直接手管 ThreadLocal<Connection> 容易出错。生产环境更推荐：
- 使用成熟的连接池（如 HikariCP），配合 Spring 的
@Transactional和DataSourceTransactionManager，它底层就基于ThreadLocal管理连接，但做了完整生命周期封装 - 若需轻量自定义，可包装
ThreadLocal成工具类，提供withConnection(Consumer<Connection>)方法，确保自动清理
