1. 導入：ThreadLocalとは何か？
JavaでWebアプリケーションを開発していると、「ログイン中のユーザー情報」や「トランザクションID」を、メソッドをまたいで受け渡したい場面が出てきます。引数ですべて渡すのは大変ですよね。そんな時に役立つのが ThreadLocal です。これは、スレッドごとに独立した値を保持できる仕組みで、静的な変数を使いつつも、スレッド間の干渉を防げるのが大きなメリットです。
2. 基礎知識：スレッドセーフな変数管理
通常、クラスのstatic変数に値を保存すると、すべてのスレッドで共有されてしまい、データが混ざる危険があります。一方、ThreadLocalを使うと、その変数にアクセスする「スレッドごと」に個別の領域が確保されます。
・スレッド固有のデータ: 他のスレッドからはその値が見えません。
・スコープ: そのスレッドが生きている間、値が保持されます。
3. 実装と使い方
ThreadLocalを利用する手順はとてもシンプルです。
1. ThreadLocalインスタンスを作成する。
2. set(値) で保存する。
3. get() で取り出す。
4. 重要：使い終わったら remove() で必ず消去する。
4. サンプルプログラム
以下のコードをコピーして実行してみてください。スレッドごとに異なるIDが管理されていることが確認できます。
public class ThreadLocalExample {
// スレッドごとにIDを管理するThreadLocal
private static final ThreadLocal threadLocal = new ThreadLocal<>();
public static void main(String[] args) {
Runnable task = () -> {
// 現在のスレッド名を取得してThreadLocalに保存
String threadName = Thread.currentThread().getName();
threadLocal.set(threadName + "のデータ");
System.out.println(threadName + "が保存した値: " + threadLocal.get());
// 処理が終わったら必ずremoveする（メモリリーク防止）
threadLocal.remove();
};
// 2つのスレッドで実行
new Thread(task, "Thread-A").start();
new Thread(task, "Thread-B").start();
}
}
5. 応用と注意点：現代のJava開発における罠
現代のJava（Java 21以降）では、Virtual Threadsが導入されています。ここで注意が必要です。
・メモリリークの危険性: スレッドプール（ExecutorService）や仮想スレッドでThreadLocalを使う際、remove()を忘れると、スレッドが再利用された時に古いデータが残ったままになります。これが原因で予期せぬバグやメモリ不足が発生します。
・CompletableFutureとの相性: CompletableFutureなどの非同期処理では、メインスレッドのThreadLocal値は引き継がれません（InheritableThreadLocalもありますが、複雑になるため推奨されません）。
・現代の解決策: 複雑なコンテキスト管理が必要な場合は、無理にThreadLocalを使わず、引数で明示的に渡す設計や、フレームワークの提供する「コンテキスト保持機能」を利用することを検討してください。
ThreadLocalは強力ですが、「使い終わったら必ず消す」というルールを徹底するだけで、トラブルの多くは回避できます。ぜひ現場の開発で活用してみてください。
コメント