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 的可调用对象。常见错误包括：
立即学习“Python免费学习笔记（深入）”；
Django Unfold
下载
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
- 未设置
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings') - settings 模块路径写错（如漏掉子包名、大小写不符）
- 在 wsgi.py 中执行了耗时初始化（如连接数据库），导致 Apache worker 启动卡死
建议只保留最小初始化逻辑，把数据库、缓存等连接延迟到第一次请求时建立。
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 "C:/myproject/static/"><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 中
不复杂但容易忽略
