You need to enable JavaScript to run this app. 在IIS上部署Django项目出现ValueError该如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

在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参数:确认配置中以下参数和本地环境完全匹配:
    1. Python解释器路径:例如C:\Python39\python.exe
    2. wfastcgi路径:例如C:\Python39\Lib\site-packages\wfastcgi.py
    3. WSGI_HANDLER值固定为django.core.wsgi.get_wsgi_application()
    4. PYTHONPATH值为SLK项目根目录的完整路径
    5. DJANGO_SETTINGS_MODULE值为SLK项目的配置入口,例如SLK.settings
  • 配置目录权限:右键点击SLK项目根目录,依次选择【属性】-【安全】-【编辑】-【添加】,输入IIS_IUSRS后校验名称并确认,给该用户组勾选【读取和执行】、【列出文件夹内容】、【读取】权限,应用到所有子目录和文件。
  • 校验FastCGI规则:打开IIS的【FastCGI设置】,确认已有对应Python3.9环境的配置条目,无对应条目则手动添加,可执行文件选择Python3.9的exe路径,参数填写wfastcgi.py的完整路径。
  • 重启验证:重启SLK对应的IIS站点,再次访问localhost:81验证服务是否正常。

内容的提问来源于stack exchange,提问作者Paweł Dawicki

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 08:18:04