将Django项目部署到IIS生产环境时出现500错误

读取WSGI处理程序时发生错误：
回溯（最近的调用最后）：
文件"c:\users\e10136\appdata\local\programs\python\python36-32\lib\site-packages\wfastcgi.py"，第791行，在main函数中 env, handler = read_wsgi_handler(response.physical_path)
文件"c:\users\e10136\appdata\local\programs\python\python36-32\lib\site-packages\wfastcgi.py"，第633行，在read_wsgi_handler函数中 h...

这个报错我部署Django到IIS时也碰过好几次，大多和配置细节、权限或者路径匹配有关，给你几个具体的排查和修复步骤：

1. 先检查web.config里的WSGI_HANDLER配置 #

这是最容易踩的坑！你的web.config里必须正确指向Django的WSGI入口，格式要严格对应：

<add key="WSGI_HANDLER" value="你的项目文件夹名.wsgi.application"/>

比如你的Django项目根目录下的wsgi.py在my_django_project文件夹里，那就要写my_django_project.wsgi.application，注意大小写要和实际文件夹名完全一致——Windows虽然不区分大小写，但wfastcgi有时候会认死理。

2. 虚拟环境路径别搞错（如果用了的话） #

要是你用了Python虚拟环境，绝对不能只依赖系统全局Python，必须在web.config里明确指定虚拟环境的路径：

<add key="PYTHONPATH" value="C:\你的项目根目录路径;C:\虚拟环境路径\Lib\site-packages"/>
<add key="WSGI_PYTHONHOME" value="C:\虚拟环境路径"/>

同时别忘了给IIS应用程序池的身份（比如IIS AppPool\你的站点名称）开通虚拟环境文件夹的读取权限，不然它连依赖包都读不到。

3. 验证wfastcgi的安装和IIS映射 #

• 先打开管理员命令行，运行pip show wfastcgi，确认它确实装在报错里的那个Python路径下（也就是python36-32的site-packages里）。
• 去IIS管理器的「服务器节点」→「FastCGI设置」里，检查有没有一条映射指向你的Python解释器（C:\Users\e10136\AppData\Local\Programs\Python\Python36-32\python.exe）和对应的wfastcgi.py，路径要完全匹配报错里的路径。
• 要是映射不对，直接在管理员命令行跑wfastcgi-enable，它会自动帮你生成正确的映射配置。

4. 给IIS站点开足权限 #

• 确保IIS应用程序池的身份对Django项目根目录有读取+执行权限，包括静态文件、媒体文件的文件夹。
• 如果用的是SQLite数据库，还要给数据库文件所在的文件夹开写入权限，不然连数据库都连不上。

5. 拿到完整报错信息 #

你现在的报错截断了（最后一行是h...），看不到关键的错误原因。可以这么做：

• 在web.config里添加这段配置，开启详细错误输出：

<system.webServer>
  <httpErrors errorMode="Detailed" />
</system.webServer>

刷新页面后就能看到完整的回溯信息，比如是找不到某个模块，还是路径写错了，一下子就能定位到问题。

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