apache托管django需通过mod_wsgi桥接,严格匹配apache/python版本、位数及编译器;配置须设wsgiscriptalias、wsgipythonhome、wsgipythonpath,并分离静态资源;django需设debug=false、allowed_hosts、static_root并运行collectstatic。

Apache 本身不能直接运行 Python 代码,必须通过 mod_wsgi 模块作为桥梁,把 HTTP 请求转成标准 WSGI 接口调用 Django 的 application 对象。这不是“加个插件就能跑”,而是要理清三者关系:Apache 负责网络通信与安全控制,mod_wsgi 负责进程管理与 Python 环境隔离,Django 负责业务逻辑——缺一不可。
确保 mod_wsgi 与 Python、Apache 版本严格匹配
这是部署失败最常见的原因。mod_wsgi 不是通用二进制,它必须和以下三项完全一致:
- Apache 的编译版本(如 VC15/VC16)、位数(x64/x86)和主版本(2.4.x)
- Python 解释器的主版本(3.7/3.8/3.9…)和构建标识(cp37、cp39)
- 操作系统平台(Windows Server 2019 / Ubuntu 22.04 / CentOS 7)
例如在 Windows 上,python 3.7.4 + Apache 2.4.39 VC15 x64,就必须使用 mod_wsgi-4.6.7+ap24vc15-cp37-cp37m-win_amd64.whl 这类精确命名的包。装错会导致 Apache 启动失败或 500 错误且日志无明确提示。
正确配置 wsgi.py 并暴露 application 对象
Django 项目根目录下的 myproject/myproject/wsgi.py 是入口文件,它必须导出一个名为 application 的可调用对象。常见错误包括:
- 未设置
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings') - settings 模块路径写错(如漏掉子包名、大小写不符)
- 在 wsgi.py 中执行了耗时初始化(如连接数据库),导致 Apache worker 启动卡死
建议只保留最小初始化逻辑,把数据库、缓存等连接延迟到第一次请求时建立。
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
Apache 配置需分离动态与静态资源处理
Django 在 DEBUG=False 时默认不提供静态文件服务,必须由 Apache 直接托管。关键配置包括:
-
WSGIScriptAlias / "/path/to/myproject/myproject/wsgi.py"—— 绑定根路径到 wsgi 入口 -
WSGIPythonHome "C:/Python37"或虚拟环境路径 —— 明确 Python 解释器位置 -
WSGIPythonPath "/path/to/myproject"—— 把项目根加进 Python 路径,确保 import 正常 - 单独为
/static/和/media/设置Alias指令,指向STATIC_ROOT和MEDIA_ROOT实际目录
例如:
Alias /static/ "C:/myproject/static/"<br><directory><br>
Require all granted<br></directory>
生产环境 Django 设置必须调整到位
仅改 Apache 配置不够,Django 自身也要适配生产要求:
-
DEBUG = False—— 关闭调试信息,防止敏感数据泄露 -
ALLOWED_HOSTS = ['example.com', 'www.example.com']—— 不能写['*'],否则 400 错误 -
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')—— 指定 collectstatic 输出目录 - 运行
python manage.py collectstatic --noinput,把所有静态文件(含 admin)合并到 STATIC_ROOT - 数据库密码、密钥等敏感项,应从环境变量读取,而非硬编码在 settings.py 中
不复杂但容易忽略
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










