Django项目部署到IIS后全站点CSS包括后台样式失效该如何解决

1. 先校验Django核心静态配置 #

确认settings.py中参数配置完全正确：

import os
# 静态资源请求前缀，必须统一为 /static/
STATIC_URL = '/static/'
# collectstatic执行后所有静态文件汇总的目标目录，必须填绝对路径
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
# 额外的静态文件查找路径，包含项目级、应用自定义的static目录
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static'),
]

配置完成后重新执行python manage.py collectstatic，确保所有静态资源（包括admin的CSS、JS）都被汇总到STATIC_ROOT对应的目录下。

2. 修正IIS配置 #

• 虚拟目录必须挂载在当前Django站点的根路径下，别名必须和STATIC_URL的前缀完全一致，即static
• 虚拟目录的物理路径直接指向上述STATIC_ROOT对应的本地文件夹，不要挂载到venv目录、应用内部static目录或站点根目录
• 给STATIC_ROOT对应的文件夹添加IUSR、IIS_IUSRS两个用户的读取与执行权限，权限不足会直接导致静态文件404
• 检查站点根目录的web.config，必须添加静态资源规则，避免静态请求被转发给Django进程：

<rules>
  <!-- 新增静态资源放行规则，放在所有规则最前面 -->
  <rule name="StaticFiles" stopProcessing="true">
    <match url="^static/.*" ignoreCase="true" />
    <action type="None" />
  </rule>
  <!-- 原有Django FastCGI转发规则放在后面 -->
  <rule name="DjangoFastCGI" stopProcessing="true">
    <match url="(.*)" ignoreCase="false" />
    <conditions>
      <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
    </conditions>
    <action type="Rewrite" url="handler.fcgi/{R:1}" appendQueryString="true" />
  </rule>
</rules>

3. 解决findstatic返回路径异常问题 #

findstatic返回venv第三方包路径是正常逻辑：STATICFILES_FINDERS默认查找顺序会优先匹配已注册应用的static目录，包括venv中安装的Django内置应用（如django.contrib.admin）的静态资源，该结果不影响生产环境静态资源加载——生产环境DEBUG=False时Django不会处理静态请求，所有/static/开头的请求会直接走IIS虚拟目录，只要IIS配置正确即可正常返回。

4. 快速定位验证 #

在STATIC_ROOT目录下新建test.txt，直接在浏览器访问你的站点地址/static/test.txt：

• 可正常访问：说明IIS静态配置无误，排查项目模板内的静态资源引用路径是否正确
• 404报错：重新检查IIS虚拟目录的别名、物理路径、文件夹权限三个配置项

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