部署Django至Windows Server 2019（IIS）时CSS文件丢失求助

嘿，我之前在Windows Server 2019上部署Django应用时，也碰到过和你一模一样的CSS丢失问题。结合我的排查经验，给你整理几个关键的解决步骤：

1. 确认Django静态文件配置并执行collectstatic #

生产环境下，Django不会自动托管静态文件，必须先完成配置并收集静态资源：

• 打开C:\inetpub\wwwroot\myapp\myapp\settings.py，检查以下配置：

  # 确保静态资源URL前缀正确
  STATIC_URL = '/static/'
  
  # 确保静态资源收集的根目录指向你的static文件夹
  STATIC_ROOT = os.path.join(BASE_DIR, 'static')
  

• 打开命令提示符，进入C:\inetpub\wwwroot\myapp目录，执行：

  python manage.py collectstatic
  

  这一步会把所有Django应用和第三方库的静态文件统一复制到STATIC_ROOT指定的文件夹里，生产环境必须执行这一步，否则静态文件会缺失。

2. 检查Static虚拟目录的权限设置 #

IIS没有权限访问静态文件夹是常见的原因：

• 打开IIS管理器，找到你的站点下的static虚拟目录，右键选择「编辑权限」；
• 在「安全」选项卡中，点击「编辑」→「添加」，输入IIS AppPool\你的应用池名称（比如你的应用池叫myappPool就输入这个），点击「检查名称」确认后添加；
• 给这个用户分配读取和执行、列出文件夹内容、读取这三个权限，点击确定保存。

3. 确保静态文件请求不被WSGI接管 #

有时候Django的WSGI处理程序会接管静态文件的请求，导致IIS无法正确返回静态资源：

• 打开站点根目录下的web.config，在<system.webServer>节点中添加静态文件的重写规则，确保/static/开头的请求直接由IIS处理：

  <rewrite>
    <rules>
      <!-- 优先处理静态文件请求 -->
      <rule name="Serve Static Files" stopProcessing="true">
        <match url="^static/(.*)$" />
        <action type="Rewrite" url="static/{R:1}" />
      </rule>
      <!-- 原有的Django路由规则 -->
      <rule name="Django Application" stopProcessing="true">
        <match url="^(.*)$" ignoreCase="false" />
        <conditions logicalGrouping="MatchAll">
          <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
        </conditions>
        <action type="Rewrite" url="wsgi.py/{R:1}" />
      </rule>
    </rules>
  </rewrite>
  

• 另外，确保static虚拟目录的「应用程序设置」中，「应用程序池」选择和主站点一致，或者直接设置为「无」（静态目录不需要运行WSGI应用）。

4. 通过浏览器控制台定位具体错误 #

打开浏览器的开发者工具（F12），切换到「控制台」标签，查看CSS文件的请求状态码：

• 如果是404 Not Found：说明静态文件路径有误，检查collectstatic是否执行、虚拟目录物理路径是否正确；
• 如果是403 Forbidden：说明权限不足，回到步骤2重新配置文件夹权限。

按上面的步骤逐一排查，应该就能解决CSS丢失的问题了。我当时就是漏了执行collectstatic，加上权限没配置到位，调整后静态资源就正常加载了。

内容的提问来源于stack exchange，提问作者M.Eugene