XAMPP 不支持原生多端口 Flask 部署,因 Apache 单进程模型下所有 VirtualHost 共享同一 Python 解释器,易致应用冲突、状态污染与模块缓存错误;必须为每个端口配置独立 WSGIDaemonProcess 并严格匹配 mod_wsgi 路径、Python 版本及虚拟环境,且 wsgi.py 仅导出 application、禁止顶层运行代码。
直接说结论:XAMPP 本身不支持原生多端口 Flask 部署,强行用
开多个端口 + 多个
是可行的,但极易因
共享 Python 解释器而崩溃——同一进程里不能安全运行多个 Flask 实例。
为什么 XAMPP 的 httpd.conf 里加多个 Listen 不等于多服务
XAMPP 的 Apache 默认是单主进程 + 多子进程模型,所有
共享同一个
和全局 Python 环境。哪怕你配置了
和
两个监听,
仍会把两个 Flask 应用加载进同一解释器空间,导致:
变量名冲突(比如都叫
)
全局状态污染(如
、Flask-Login 的 session 设置互相覆盖)
Python 模块导入缓存(
和
可能被当成同一个模块)
典型现象:
或启动后某一个端口返回另一个应用的内容。
mod_wsgi-express module-config 输出的配置必须逐项核对
运行
后,它输出的三行不是“复制粘贴就能用”的模板,而是强绑定当前 Python 版本、架构和
编译参数的硬编码路径:
—— 必须和你的 Python 安装路径完全一致,不能写成
或漏掉版本号
—— 文件名中的
和
必须匹配你安装的 wheel 包,否则 Apache 启动失败且日志只报
—— 若你用了虚拟环境,这里必须指向虚拟环境根目录(如
),而不是系统 Python
漏掉任一匹配,Apache 会静默失败或在访问时返回 500 错误,
里可能只有一行
。
每个端口必须配独立的 WSGIDaemonProcess
想让两个 Flask 应用真正隔离,不能只靠
,必须为每个端口声明独立的守护进程:
关键点:
名字(
/
)必须唯一,且与后续
严格一致
要包含应用所在目录(让
找得到),不能只写
Windows 下
默认使用
,高并发场景需显式加
,否则请求排队
漏掉
,所有请求仍会落到默认进程组,两个应用还是共享内存。
wsgi.py 文件必须导出 application,且不能有 top-level 运行代码
这是最常被忽略的细节。以下写法是错的:
正确写法只有两行:
原因:
加载
时会执行全部顶层代码。一旦触发
,Apache 主进程就被卡死,后续请求全超时;而
语句会写入 Apache 的
,但不会报错,只会让日志变得难以排查。
复杂点在于:XAMPP 的 Apache 是 Windows 服务,重启不彻底时旧进程残留,
的 Python 子进程不会自动回收。每次改完配置,务必用任务管理器杀掉所有
,再手动启动服务,否则看到的永远是上一次的缓存行为。
ListenVirtualHostmod_wsgiVirtualHostWSGIPythonHome*:5000*:6000mod_wsgiappapplicationapp.configimport myapp1import myapp2ImportError: cannot import name 'application'mod_wsgi-express module-configmod_wsgiLoadFile "C:/Python310/python310.dll"python3.dllLoadModule wsgi_module "C:/Python310/lib/site-packages/mod_wsgi/server/mod_wsgi.cp310-win_amd64.pyd"cp310win_amd64Cannot load mod_wsgi.soWSGIPythonHome "C:/Python310"C:/venv/myflaskerror.logmod_wsgi (pid 1234): Target WSGI script 'd:/test/wsgi.py' cannot be loadedVirtualHostWSGIDaemonProcess app1 python-path="d:/app1" python-home="C:/venv/app1"
WSGIProcessGroup app1
WSGIScriptAlias / d:/app1/wsgi.py
WSGIDaemonProcess app2 python-path="d:/app2" python-path="d:/app2" python-home="C:/venv/app2"
WSGIProcessGroup app2
WSGIScriptAlias / d:/app2/wsgi.py
WSGIDaemonProcessapp1app2WSGIProcessGrouppython-pathimport apppython-homeWSGIDaemonProcessthreads=1threads=5WSGIProcessGroupfrom flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
return 'hello'
if name == 'main':
app.run() # ← 这行会导致 Apache 启动时就执行 run(),阻塞进程
from myapp import app as application
# 不要任何 if __name__ == ...,不要 print,不要 app.run()mod_wsgiwsgi.pyapp.run()printerror.logmod_wsgihttpd.exe