Python 3.12升级后ThreadingHTTPServer请求处理崩溃求助

我有一个基于http.server.ThreadingHTTPServer的Python HTTP服务器，部署在Docker容器中。在Python 3.11环境下运行正常，但升级到Python 3.12后，一旦有HTTP请求进来就崩溃，报错如下：

Exception occurred during processing of request from ('127.0.0.1', 50544)
Traceback (most recent call last):
  File "/usr/local/lib/python3.12/socketserver.py", line 318, in _handle_request_noblock
    self.process_request(request, client_address)
  File "/usr/local/lib/python3.12/socketserver.py", line 706, in process_request
    t.start()
  File "/usr/local/lib/python3.12/threading.py", line 971, in start
    _start_new_thread(self._bootstrap, ())
RuntimeError: can't create new thread at interpreter shutdown

对应的Dockerfile内容：

FROM python:alpine
RUN pip3 install requests psycopg2-binary semantic-version
COPY mysource /
ENTRYPOINT /myprogram.py

服务器核心代码：

def runServer():
    server = http.server.ThreadingHTTPServer(('0.0.0.0', 1234), Server)
    server.serve_forever()

# 其他业务代码...
thread = threading.Thread(target=runServer)
thread.start()
# 其他业务代码...

已知用HTTPServer替代ThreadingHTTPServer可解决问题，Python 3.11镜像下无此异常。

问题根源 #

这个问题是Python 3.12对线程生命周期管理的收紧导致的：当主线程执行完毕进入解释器关闭流程时，新版本严格禁止创建新线程。而你的代码中，启动服务器的线程如果没有让主线程保持存活，会触发解释器提前shutdown，此时ThreadingHTTPServer试图为请求创建处理线程时就会抛出上述错误。Python 3.11及之前版本对这个时机的检查没有这么严格。

可行解决办法 #

1. 让主线程等待服务器线程 #

启动服务器线程后调用join()，确保主线程不会提前退出，避免解释器进入shutdown状态：

def runServer():
    server = http.server.ThreadingHTTPServer(('0.0.0.0', 1234), Server)
    server.serve_forever()

thread = threading.Thread(target=runServer)
thread.start()
# 主线程阻塞等待服务器线程，防止提前退出
thread.join()

2. 直接在主线程启动服务器（最稳妥） #

不需要额外创建线程，直接在主线程调用runServer()，serve_forever()会一直阻塞主线程，从根源避免解释器提前关闭：

if __name__ == "__main__":
    runServer()

3. 调整Docker的ENTRYPOINT命令 #

原命令未显式指定Python解释器，可能存在执行环境差异。改成显式调用python3运行脚本，提升稳定性：

ENTRYPOINT ["python3", "/myprogram.py"]

4. 给服务器线程设置守护线程（需配合主线程存活逻辑） #

如果主线程需要执行其他任务，可以把服务器线程设为守护线程，但必须保证主线程不会提前退出：

import time

thread = threading.Thread(target=runServer, daemon=True)
thread.start()
# 主线程保持运行，比如添加无限阻塞逻辑
while True:
    time.sleep(3600)

是否有其他人遇到该问题？ #

是的，已有不少开发者在升级Python 3.12后遇到类似的线程创建限制问题，尤其是使用ThreadingHTTPServer或其他动态创建线程的服务场景，核心原因都是新版本对解释器shutdown阶段的线程创建规则收紧。

内容的提问来源于stack exchange，提问作者Wolfram Rösler