Windows10下Apache部署Flask遇select标准库找不到错误求助

环境信息 #

• 系统：Windows10
• Apache版本：2.4.57
• Python版本：3.11.1
• Flask应用：简单Hello World示例

错误现象 #

运行httpd.exe后访问localhost页面出现500内部服务器错误，Apache日志中的堆栈跟踪如下：

[Thu Oct 12 17:16:08.747857 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047] mod_wsgi (pid=19784): Failed to exec Python script file 'path/to/flask/and/wsgi/file/FlaskApp.wsgi'.
[Thu Oct 12 17:16:08.748944 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047] mod_wsgi (pid=19784): Exception occurred processing WSGI script 'C:/Users/Public/Documents/git/Apache/FlaskApp.wsgi'.
[Thu Oct 12 17:16:08.749916 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047] Traceback (most recent call last):\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]   File "C:/Users/Public/Documents/git/Apache/FlaskApp.wsgi", line 7, in <module>\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]     from f import app as application\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]   File "path/to/flask/and/wsgi/file\\f\\__init__.py", line 1, in <module>\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]     from f.main import app\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]   File "path/to/flask/and/wsgi/file\\f\\main.py", line 1, in <module>\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]     from flask import Flask\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]   File "path/to/flask/and/wsgi/file\\venv\\Lib\\site-packages\\flask\\__init__.py", line 5, in <module>\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]     from . import json as json\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]   File "path/to/flask/and/wsgi/file\\venv\\Lib\\site-packages\\flask\\json\\__init__.py", line 6, in <module>\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]     from ..globals import current_app\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]   File "path/to/flask/and/wsgi/file\\venv\\Lib\\site-packages\\flask\\globals.py", line 6, in <module>\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]     from werkzeug.local import LocalProxy\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]   File "path/to/flask/and/wsgi/file\\venv\\Lib\\site-packages\\werkzeug\\__init__.py", line 5, in <module>\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]     from .serving import run_simple as run_simple\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]   File "path/to/flask/and/wsgi/file\venv\\Lib\\site-packages\\werkzeug\\serving.py", line 19, in <module>\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]     import selectors\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]   File "path\to\user\\AppData\\Local\\Programs\\Python\\Python311\\Lib\\selectors.py", line 12, in <module>\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047]     import select\r
[Thu Oct 12 17:16:08.751860 2023] [wsgi:error] [pid 19784:tid 876] [client 127.0.0.1:53047] ModuleNotFoundError: No module named 'select'\r

select是Python标准库，单独运行Flask或Apache均正常，仅结合部署时出错。

应用代码 #

main.py #

from flask import Flask

app = Flask(__name__)

@app.route("/")
def hello():
    return "Hello World!"

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

init.py #

from f.main import app

配置文件 #

FlaskApp.wsgi #

import sys
import logging
logging.basicConfig(stream=sys.stderr)
sys.path.insert(0, "path/to/flask/and/wsgi/file/f")   
sys.path.insert(0, "path/to/flask/and/wsgi/file")   

from f import app as application

Apache虚拟主机配置（myapp.conf） #

<VirtualHost *:5000>
    servername flaskwill.com
    <Directory path/to/flask/and/wsgi/file/>
        Require all granted
    </Directory>
    <Directory path/to/flask/and/wsgi/file/f>
        Require all granted
    </Directory>
    WSGIScriptAlias / path/to/flask/and/wsgi/file/FlaskApp.wsgi   
</VirtualHost>

httpd.conf中已包含mod_wsgi-express module-config输出的LoadFile、LoadModule和WSGIPythonHome配置。

已尝试的解决方法 #

• 用户路径含空格，但能找到selectors.py，排除此问题
• 改用virtualenv替代venv，无变化

这个问题的核心原因是Windows系统上的mod_wsgi版本与Python版本不兼容，或者mod_wsgi编译时使用的Python环境和当前运行的环境不一致。select模块在Windows的Python中是存在的，但mod_wsgi加载Python解释器时出现异常，导致无法找到标准库模块。

具体修复步骤： #

1. 确认mod_wsgi与Python版本匹配

   • 确保安装的mod_wsgi是针对Python 3.11.x编译的Windows版本。如果是通过pip安装的，卸载后重新安装对应版本：

     pip uninstall mod_wsgi
     pip install mod_wsgi==匹配Python3.11的版本
     

   • 可以通过mod_wsgi --version查看版本信息，确认是否支持Python3.11。

2. 检查WSGIPythonHome配置

   • 确保httpd.conf中的WSGIPythonHome指向正确的Python安装目录（或虚拟环境目录），路径若含空格需用引号包裹：

     WSGIPythonHome "C:/Users/John Smith/AppData/Local/Programs/Python/Python311"
     

   • 若使用虚拟环境，指向虚拟环境根目录：

     WSGIPythonHome "path/to/flask/and/wsgi/file/venv"
     

3. 在WSGI文件中指定虚拟环境的site-packages路径

   • 在FlaskApp.wsgi中添加虚拟环境的site-packages路径，确保mod_wsgi能找到依赖：

     import sys
     import logging
     logging.basicConfig(stream=sys.stderr)
     # 添加虚拟环境的site-packages路径
     sys.path.insert(0, "path/to/flask/and/wsgi/file/venv/Lib/site-packages")
     sys.path.insert(0, "path/to/flask/and/wsgi/file/f")   
     sys.path.insert(0, "path/to/flask/and/wsgi/file")   
     
     from f import app as application
     

4. 统一32位/64位版本

   • 确保Apache、mod_wsgi、Python三者的位数一致（均为32位或均为64位），混合位数会导致模块加载错误。

5. 重新生成mod_wsgi配置

   • 再次运行mod_wsgi-express module-config，复制输出的配置到httpd.conf中替换旧配置，确保路径正确。

验证方法 #

修改配置后重启Apache，访问页面。若仍报错，检查Apache日志，确认是否还有模块找不到的问题或新的错误信息。

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