Skip to content

[3.15] gh-115634: Fix ProcessPoolExecutor deadlock with max_tasks_per_child (GH-140900)#152926

Merged
gpshead merged 1 commit into
python:3.15from
miss-islington:backport-b706767-3.15
Jul 3, 2026
Merged

[3.15] gh-115634: Fix ProcessPoolExecutor deadlock with max_tasks_per_child (GH-140900)#152926
gpshead merged 1 commit into
python:3.15from
miss-islington:backport-b706767-3.15

Conversation

@miss-islington

@miss-islington miss-islington commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

The idle worker semaphore counts task completions, not idle workers, so
it can hold a stale token released by a worker that later exited upon
reaching its max_tasks_per_child limit. The worker replacement path
consumed such tokens and skipped spawning a replacement, deadlocking
the remaining queued tasks once no workers were left.

Replace dead workers based on len(self._processes) without consulting
the semaphore. The submit() path is unchanged, preserving on-demand
spawning and idle worker reuse.

Replace the documentation note added in GH-140897 with a versionchanged
entry now that the bug is fixed.

Based on a fix proposed by Tabrez Mohammed.
(cherry picked from commit b706767)

Co-authored-by: Gregory P. Smith 68491+gpshead@users.noreply.github.com

…child (pythonGH-140900)

The idle worker semaphore counts task completions, not idle workers, so
it can hold a stale token released by a worker that later exited upon
reaching its max_tasks_per_child limit. The worker replacement path
consumed such tokens and skipped spawning a replacement, deadlocking
the remaining queued tasks once no workers were left.

Replace dead workers based on len(self._processes) without consulting
the semaphore. The submit() path is unchanged, preserving on-demand
spawning and idle worker reuse.

Replace the documentation note added in pythonGH-140897 with a versionchanged
entry now that the bug is fixed.

Based on a fix proposed by Tabrez Mohammed.
(cherry picked from commit b706767d8fd7d21afc3f156fb9c173bc99855e0e)

Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>
@read-the-docs-community

Copy link
Copy Markdown

@gpshead gpshead merged commit c8c08cf into python:3.15 Jul 3, 2026
55 checks passed
@miss-islington miss-islington deleted the backport-b706767-3.15 branch July 3, 2026 06:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants