<div class="key-takeaways"><ul><li>ThreadLocal อยู่คู่ Java มาตั้งแต่เวอร์ชัน 1.2 แต่เริ่มพบข้อจำกัดเมื่อเจอ Virtual Threads</li><li>ปัญหาใหญ่คือหน่วยความจำรั่วไหล (Memory Leak) และความเสี่ยงด้านความปลอดภัยเมื่อใช้ร่วมกับ Thread Pool</li><li>Java 21 นำเสนอ Scoped Values (JEP 446) เป็นทางเลือกสมัยใหม่ที่ปลอดภัยและมีประสิทธิภาพกว่า</li><li>หากยังจำเป็นต้องใช้ ThreadLocal ใน Java 21 ต้องเรียกใช้งานผ่าน try-finally และ .remove() เสมอ</li></ul></div><p>นักพัฒนาซอฟต์แวร์หลายท่านคงคุ้นเคยกับการใช้ ThreadLocal ในภาษา Java สำหรับเก็บข้อมูลเฉพาะกิจของแต่ละเธรด เช่น รหัสผู้ใช้งาน (userId) ในแต่ละคำขอ (request) หรือการเชื่อมต่อฐานข้อมูลที่ไม่สามารถแชร์ข้ามกันได้ แต่เมื่อยุคสมัยเปลี่ยนไปและการมาถึงของ Virtual Threads ใน JDK 21 ทำให้การสร้างเธรดน้ำหนักเบานับล้านกลายเป็นเรื่องจริง และส่งผลให้จุดอ่อนของ ThreadLocal ปรากฏชัดเจนขึ้น</p><p>ThreadLocal ถูกออกแบบมาให้ตัวแปรเข้าถึงและแก้ไขได้เฉพาะเธรดนั้น ๆ โดยแต่ละเธรดจะมีสำเนาอิสระของตัวเอง แต่ปัญหาจะเกิดขึ้นทันทีหากนักพัฒนาลืมเรียกฟังก์ชัน remove() ทำให้ข้อมูลค้างอยู่ในเธรด ยิ่งในระบบที่ใช้ Thread Pool ซึ่งมีการนำเธรดกลับมาวนใช้ซ้ำ อาจทำให้ผู้ใช้งานรายหนึ่งมองเห็นข้อมูลของอีกรายได้ กลายเป็นฝันร้ายด้านความปลอดภัยที่คาดเดาได้ยากและสร้างความสับสนในการทำเทสต์</p><div class="mb-20"><img class="img-bdrd-16" src="https://api.inewgen.co/uploads/threadlocal_java_21_scoped_values_ms6p12m8_inline_1_5127ff29cf.jpg" alt="java software architecture diagram" loading="lazy" /><p class="color-gray-500 text-sm mt-10">ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง</p></div><div class="ai-insight"><p>การเปลี่ยนผ่านจาก Platform Threads แบบเดิมมาสู่ Virtual Threads ใน Java 21 ถือเป็นการปฏิวัติสถาปัตยกรรมครั้งใหญ่ เนื่องจาก Virtual Threads ถูกออกแบบมาให้มีน้ำหนักเบาและเกิดดับได้ในเสี้ยววินาที การนำ ThreadLocal ไปผูกกับเธรดที่มีลักษณะเช่นนี้จึงเสี่ยงต่อการเกิดปัญหา Heap Explosion หรือหน่วยความจำระเบิดเมื่อมีการจัดเก็บวัตถุขนาดใหญ่ Scoped Values จึงถูกพัฒนาขึ้นมาเพื่อผูกข้อมูลเข้ากับ "บล็อกของโค้ด" แทนที่จะผูกกับอายุขัยของเธรดโดยตรง</p></div><p>ความท้าทายหลักของ ThreadLocal เมื่อใช้งานร่วมกับ Virtual Threads มีดังนี้:</p><ul><li>Virtual Threads มีจำนวนมากและถูกสร้าง-ทำลายอย่างรวดเร็ว ทำให้การใช้ ThreadLocal สิ้นเปลืองหน่วยความจำ</li><li>หาก Virtual Threads สิ้นสุดการทำงานแต่ค่าใน ThreadLocal ไม่ถูกล้าง ข้อมูลนั้นจะยังคงตกค้างในหน่วยความจำ</li><li>แม้ใน JDK 21 จะรองรับ ThreadLocal บน Virtual Threads เพื่อความเข้ากันได้กับไลบรารีเก่า แต่ไม่ได้แปลว่าเป็นแนวปฏิบัติที่ควรทำ</li></ul><p>ทางออกที่ทันสมัยใน JDK 21 คือ Scoped Values ตามข้อเสนอ JEP 446 ซึ่งเข้ามาเปลี่ยนกระบวนทัศน์การจัดการข้อมูลให้ปลอดภัยและจัดการได้ง่ายขึ้น หากคุณรันแอปพลิเคชันบน Java 21 และใช้งาน Virtual Threads ควรมุ่งหน้าสู่ ScopedValue เป็นอันดับแรก และหลีกเลี่ยง ThreadLocal เว้นแต่มีความจำเป็นจริง ๆ ที่ต้องห่อหุ้มด้วย try-finally และ .remove() ทุกครั้ง</p><p class="source-attribution">ที่มา: <img src="https://www.google.com/s2/favicons?domain=dev.to&sz=64" alt="Dev.to" class="source-logo" width="16" height="16" /> <a href="https://dev.to/fabiothomazrocha/threadlocal-no-java-21-o-que-mudou-o-que-continua-e-quando-voce-deve-ou-nao-usar-36gi" target="_blank" rel="noopener noreferrer">Dev.to</a></p>

<div class="key-takeaways"><ul><li>ThreadLocal has been a Java staple since version 1.2 but struggles with Virtual Threads.</li><li>Major risks include memory leaks and security vulnerabilities when paired with thread pools.</li><li>Java 21 introduces Scoped Values (JEP 446) as a modern, safer, and faster alternative.</li><li>If ThreadLocal must be used in Java 21, always wrap execution in try-finally and call remove().</li></ul></div><p>Developers who have spent hours debugging uncleaned ThreadLocal variables leading to memory leaks are likely very familiar with this utility. Since Java 1.2, it has served as the go-to solution for storing thread-confined data, such as a request's userId or a non-shareable database connection. However, with the introduction of Virtual Threads in JDK 21, creating millions of lightweight threads became a reality, exposing the inherent weaknesses of ThreadLocal.</p><p>ThreadLocal creates variables accessible and modifiable only by the same thread, giving each thread an independent copy. If you forget to invoke remove(), the value remains trapped inside the thread. In thread pool scenarios where threads are reused, one request can inherit the ThreadLocal data of a previous request, leading to severe security nightmares where User A views User B's sensitive information.</p><div class="mb-20"><img class="img-bdrd-16" src="https://api.inewgen.co/uploads/threadlocal_java_21_scoped_values_ms6p12m8_inline_1_5127ff29cf.jpg" alt="java software architecture diagram" loading="lazy" /><p class="color-gray-500 text-sm mt-10">Stock photo for illustration only, not from the actual event</p></div><div class="ai-insight"><p>The transition from traditional platform threads to Virtual Threads in Java 21 marks a fundamental architectural shift. Because virtual threads are lightweight and disposable, appearing and disappearing in fractions of a millisecond, attaching ThreadLocal to them can easily cause heap explosions if large objects are stored. Scoped Values shift the paradigm by tying data to code blocks rather than thread lifecycles, offering superior safety and predictability.</p></div><p>Key challenges of using ThreadLocal with virtual threads include:</p><ul><li>Virtual threads are cheap and abundant, making ThreadLocal storage dangerously memory-intensive at scale.</li><li>If a virtual thread terminates without clearing its ThreadLocal, the data persists in memory after the thread dies.</li><li>Although JDK 21 supports ThreadLocal on virtual threads for backwards compatibility, it demands extreme caution.</li></ul><p>The modern remedy in Java 21 is Scoped Values (JEP 446). If you are operating on Java 21 and utilizing virtual threads, ScopedValue is the recommended approach to avoid unnecessary memory overhead and complexity. Whenever ThreadLocal remains mandatory, developers must rigorously enforce try-finally blocks and invoke remove().</p><p class="source-attribution">Source: <img src="https://www.google.com/s2/favicons?domain=dev.to&sz=64" alt="Dev.to" class="source-logo" width="16" height="16" /> <a href="https://dev.to/fabiothomazrocha/threadlocal-no-java-21-o-que-mudou-o-que-continua-e-quando-voce-deve-ou-nao-usar-36gi" target="_blank" rel="noopener noreferrer">Dev.to</a></p>

medium_threadlocal-java-21-scoped-values-ms6p12m8.jpg

small_threadlocal-java-21-scoped-values-ms6p12m8.jpg

thumbnail_threadlocal-java-21-scoped-values-ms6p12m8.jpg

Inewgen

Inewgen

#ThreadLocal

ThreadLocal in Java 21: What Changed, What Remains, and When to Use Scoped Values

Inewgen