Docker中运行Python 3.8出现RuntimeError: can't start new thread问题求助

1 优先排查Docker运行时限制 #

容器内看到的ulimit为unlimited不代表实际无限制，Docker守护进程的默认规则会覆盖容器内配置，可按以下顺序验证：

• 检查PID数量限制：Linux下线程本质是轻量进程，每创建一个线程会占用一个PID号。运行docker inspect <你的容器ID> | grep PidsLimit查看容器PID上限，Fedora 35配套的Docker版本默认PID限制通常为4096，若容器内已有其他进程占用大量PID，会无法创建新线程。可在启动容器时添加--pids-limit=-1参数临时解除PID限制复测。
• 检查进程数ulimit限制：启动容器时显式指定进程数上限参数--ulimit nproc=65535:65535，覆盖Docker默认的ulimit配置后复测。
• 检查内存限制：每个Python线程默认分配8M栈内存，若容器启动时设置了极低的内存上限，也会触发线程创建失败。运行docker stats <你的容器ID>查看容器内存占用与上限，可临时用--memory=1G参数调高内存限制复测。

2 检查宿主系统内核限制 #

• 查看宿主PID上限：运行cat /proc/sys/kernel/pid_max，若宿主整机PID占用已达上限，容器也无法申请新的PID用于创建线程。
• 查看宿主普通用户进程数限制：运行ulimit -u查看启动Docker进程的用户的进程数上限，若该用户运行的总进程数触顶，容器内也无法创建新线程。

3 排查Fedora 35特殊适配问题 #

• Fedora 35默认启用Cgroup V2，旧版本Docker对Cgroup V2的资源隔离适配存在缺陷，可在启动容器时添加--cgroupns=host参数复用宿主Cgroup命名空间复测。
• 检查Seccomp规则限制：Docker默认的Seccomp安全规则可能拦截线程创建相关系统调用，可临时用--security-opt seccomp=unconfined参数关闭Seccomp限制复测，若恢复正常可自定义Seccomp规则放开对应权限即可。

内容的提问来源于stack exchange，提问作者Kryštof Řeháček