在IIS上部署Django项目出现ValueError该如何解决?
IIS部署Django项目故障排查与解决方案
排查思路
- 校验web.config配置与存放位置:不要将web.config放在C:\inetpub\wwwroot根目录,需确认文件存放在SLK项目根目录,且IIS站点的物理路径指向SLK项目根目录而非wwwroot。同时检查配置中Python解释器路径、wfastcgi路径、项目WSGI入口、Django配置文件路径是否和本地环境一致。
- 检查站点目录权限:确认SLK项目所有目录已给IIS_IUSRS用户组开放读取、执行权限,权限不足是IIS部署Python项目最常见的报错原因。
- 端口占用校验:执行
netstat -ano | findstr "81"命令,确认81端口未被其他进程占用,且IIS站点绑定的81端口无IP访问限制。 - wfastcgi服务校验:确认已执行
wfastcgi-enable命令开启FastCGI服务,且IIS处理程序映射中已添加对应Python环境的FastCGI映射规则。 - Django配置校验:检查settings.py中ALLOWED_HOSTS是否已添加
localhost、127.0.0.1,若已关闭DEBUG模式需确认已配置STATIC_ROOT并执行python manage.py collectstatic完成静态资源收集。
解决方案
- 修正站点配置:打开IIS管理器,将SLK站点的物理路径修改为SLK项目的根目录,将存放在wwwroot下的web.config文件移回SLK项目根目录。
- 修正web.config参数:确认配置中以下参数和本地环境完全匹配:
- Python解释器路径:例如
C:\Python39\python.exe - wfastcgi路径:例如
C:\Python39\Lib\site-packages\wfastcgi.py - WSGI_HANDLER值固定为
django.core.wsgi.get_wsgi_application() - PYTHONPATH值为SLK项目根目录的完整路径
- DJANGO_SETTINGS_MODULE值为SLK项目的配置入口,例如
SLK.settings
- Python解释器路径:例如
- 配置目录权限:右键点击SLK项目根目录,依次选择【属性】-【安全】-【编辑】-【添加】,输入
IIS_IUSRS后校验名称并确认,给该用户组勾选【读取和执行】、【列出文件夹内容】、【读取】权限,应用到所有子目录和文件。 - 校验FastCGI规则:打开IIS的【FastCGI设置】,确认已有对应Python3.9环境的配置条目,无对应条目则手动添加,可执行文件选择Python3.9的exe路径,参数填写wfastcgi.py的完整路径。
- 重启验证:重启SLK对应的IIS站点,再次访问localhost:81验证服务是否正常。
内容的提问来源于stack exchange,提问作者Paweł Dawicki
相关产品推荐
相关产品推荐

