Windows Server IIS部署Django应用失败，求排查方案

问题描述 #

我是一名习惯Linux开发的程序员，最近在客户的Windows Server 2016上部署Django应用时卡壳了——客户要求必须用IIS部署，这玩意儿我之前完全没接触过。我查了不少资料，其中最靠谱的是Matt Woodward几年前的一篇教程，但照着操作后还是没能成功，现在实在摸不着头脑，求各位大佬帮忙排查问题！

环境参数 #

• Django版本：4.2
• wfastcgi版本：3.0
• Python版本：3.11
• 操作系统：Windows Server 2016

我的操作流程 #

一、依赖环境搭建

1. 给服务器安装了Python和IIS服务；
2. 创建了虚拟环境，安装了项目所有依赖包以及wfastcgi；
3. 用python manage.py runserver测试Django应用，运行完全正常。

二、FastCGI配置

• 可执行文件路径：C:\Users\one\Documents\app\myApplication\virtualenv\Scripts\python.exe
• 参数设置：C:\Users\one\Documents\app\myApplication\virtualenv\Lib\site-packages\wfastcgi.py
• 环境变量：
  • DJANGO_SETTINGS_MODULE: core.settings
  • PYTHONPATH: C:\Users\one\Documents\app\myApplication\core
  • WSGI_HANDLER: django.core.wsgi.get_wsgi_application()

三、IIS站点配置

• 物理路径/内容目录：C:\Users\one\Documents\app\myApplication\core
• 处理程序映射：
  • 请求路径：*
  • 模块：FastCgiModule
  • 可执行文件：C:\Users\one\Documents\app\myApplication\virtualenv\Scripts\python.exe|C:\Users\one\Documents\app\myApplication\virtualenv\Lib\site-packages\wfastcgi.py

当前故障 #

访问http://localhost:81时出现错误页面（未获取到具体错误内容），不确定是配置环节出了问题还是权限不足导致的，有没有排查方向可以推荐？

排查方案&解决建议 #

作为踩过不少IIS部署Django坑的过来人，给你几个实用的排查方向：

1. 先修正可能的路径配置错误

• PYTHONPATH设置不合理：你现在把PYTHONPATH指向了core子目录，但Django需要的是项目根目录（也就是myApplication），这样才能正确识别项目的包结构和manage.py文件。建议把PYTHONPATH改成C:\Users\one\Documents\app\myApplication，修改后重启IIS站点再测试。
• 核对路径拼写：仔细检查FastCGI和IIS配置里的所有路径，确保没有拼写错误、大小写问题（Windows路径不区分大小写，但最好统一）。

2. 权限问题是头号嫌疑犯

• 调整应用池身份权限：默认的IIS应用池身份权限很低，大概率无法访问你的项目目录和虚拟环境。可以临时把应用池身份改成LocalSystem测试（不建议长期使用，风险较高），或者给当前应用池用户（格式是IIS AppPool\你的站点名称）添加项目文件夹的读写权限，包括虚拟环境目录、Django项目目录，以及静态文件/media目录（如果项目用到的话）。
• 检查文件权限：确保python.exe和wfastcgi.py所在目录允许IIS进程读取和执行。

3. 用日志定位具体错误

• 开启IIS详细错误：在IIS管理器中找到你的站点，开启“详细错误”选项，这样就能看到具体的错误代码和描述，而不是默认的模糊错误页面。
• 配置wfastcgi日志：在FastCGI的环境变量里新增WSGI_LOG=C:\Users\one\Documents\app\myApplication\wfastcgi.log，wfastcgi会把运行时的报错信息写入这个文件，能帮你精准定位问题（比如模块找不到、依赖缺失、权限不足等）。
• 查看Django日志：如果你的项目配置了Django日志，去对应的日志文件里找找有没有相关报错记录。

4. 静态文件配置是否遗漏

如果是页面加载异常或者静态文件404，那可能是没配置静态文件处理：

• 先在虚拟环境中运行python manage.py collectstatic，把所有静态文件收集到指定的STATIC_ROOT目录；
• 在IIS中给这个静态目录添加“静态内容”处理程序，或者单独设置一个虚拟目录指向该文件夹。

5. 其他细节检查

• 端口占用：用命令netstat -ano | findstr :81检查81端口是否被其他程序占用，确保IIS站点能正常绑定该端口。
• 虚拟环境依赖：激活虚拟环境，运行pip list确认Django、wfastcgi等依赖都正确安装，没有版本冲突。
• 重启IIS：有时候配置修改后需要重启整个IIS服务才能生效，执行iisreset命令试试。

试试这些方法，应该能找到问题所在！

备注：内容来源于stack exchange，提问作者Eduardo Fellipe