Python 3.8虚拟环境运行Flask服务报模块缺失报错的原因

在Python 3.8版本的虚拟环境下，运行如下自定义Flask HTTP服务代码时，触发连续模块导入错误，无法正常启动程序：

from flask import Flask, request

app = Flask(__name__)


@app.route("/")
def index():
    print(request.get_json())


if __name__ == "__main__":
    app.run(debug=True)

触发的完整运行报错 #

python tools/fake.pyTraceback (most recent call last):
  File "/home/ubuntu/workspace/otc/venv/lib/python3.8/site-packages/werkzeug/serving.py", line 58, in <module>
    from http.server import BaseHTTPRequestHandler
ModuleNotFoundError: No module named 'http.server'; 'http' is not a package

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "tools/fake.py", line 1, in <module>
    from flask import Flask, request
  File "/home/ubuntu/workspace/otc/venv/lib/python3.8/site-packages/flask/__init__.py", line 16, in <module>
    from werkzeug.exceptions import abort
  File "/home/ubuntu/workspace/otc/venv/lib/python3.8/site-packages/werkzeug/__init__.py", line 15, in <module>
    from .serving import run_simple
  File "/home/ubuntu/workspace/otc/venv/lib/python3.8/site-packages/werkzeug/serving.py", line 61, in <module>
    import SocketServer as socketserver
ModuleNotFoundError: No module named 'SocketServer'

报错核心原因 #

• 第一处直接报错ModuleNotFoundError: No module named 'http.server'; 'http' is not a package，并非Python 3.8本身缺失标准库，而是项目路径中存在与Python标准库重名的http.py文件，或无__init__.py标识的http目录。Python导入模块时会优先搜索当前执行脚本的所在路径，这个自定义的同名文件会被优先识别为http模块，但它不包含server子模块，因此无法完成导入。
• 第二处连锁报错ModuleNotFoundError: No module named 'SocketServer'是Werkzeug的兜底逻辑触发的：当http.server导入失败时，适配Python 2的旧版Werkzeug会尝试导入Python 2时代的模块名SocketServer，但Python 3 环境中该模块早已重命名为socketserver，因此会连续触发报错。

修复操作步骤 #

• 排查项目根目录、脚本所在的tools目录下，是否存在名称为http.py的文件，或名称为http的普通文件夹，找到后直接将其重命名为不与标准库冲突的名称，解除导入路径抢占问题。
• 检查虚拟环境中安装的Werkzeug版本：执行pip list | grep Werkzeug查看版本号，若为适配Python2的0.x系列旧版本，执行pip install werkzeug==2.0.3（适配Python3.8的稳定版本）完成安装，替换不兼容的旧版本。
• 修复完成后，在项目根目录执行验证命令python -c "import http.server; print('标准库导入正常')"，若能正常输出提示，说明导入路径冲突已完全解决。

内容的提问来源于stack exchange，提问作者Rodrigo