Unveiling ThreadPoolExecutor’s Hidden Locks: Why mainLock and Worker Locks Matter

During a recent interview, a candidate was asked to explain the locks used inside Java's ThreadPoolExecutor, revealing that many overlook these internal synchronization mechanisms.

mainLock

The ThreadPoolExecutor maintains a mainLock field, which is a ReentrantLock protecting the non‑thread‑safe HashSet that stores worker threads.

This lock guards two critical shared resources: the workers set and the largestPoolSize field, which records the maximum number of threads that have ever existed in the pool.

Using a lock instead of a concurrent set simplifies bookkeeping and prevents “interrupt storms” during shutdown, as described in the source comment:

While we could use a concurrent set of some sort, it turns out to be generally preferable to use a lock.

Another comment explains that the lock serializes interruptIdleWorkers, avoiding unnecessary interrupts, especially when shutdown is invoked.

Changing largestPoolSize to volatile would remove the need for locking, but the lock also ensures that the value read after addWorker completes is consistent.

Another Lock

Each worker thread is represented by a Worker class that extends AbstractQueuedSynchronizer and implements its own non‑reentrant mutual‑exclusion lock.

The worker lock is used in runWorker to protect the thread’s interrupt‑control state, ensuring that a thread executing a task is not interrupted.

Key methods such as lock and tryLock manipulate an internal state that transitions from -1 (unstarted), to 0 (unlocked), and 1 (locked). The state is set to -1 when the worker is added to the pool but has not yet started running.

Because the worker lock is non‑reentrant, pool‑control operations like setCorePoolSize cannot reacquire it, preventing accidental interruption of running tasks.

Overall, the combination of mainLock and the worker‑level lock provides safe access to internal data structures, accurate statistics, and controlled interruption handling within the thread pool.