Django项目中static子目录下CSS文件无法正常加载问题排查

嘿，我太懂这种“配置看着全对，但静态文件就是抽风”的感觉了——毕竟好久没从零搭Django，很容易忽略一些细节。咱们来一步步排查你可能遗漏的点：

1. 先看开发服务器的请求日志（最直接的排查方式） #

运行python manage.py runserver后，盯着控制台输出。当你访问hi.html时，会看到类似这样的请求记录：

[12/Oct/2024 14:32:00] "GET /static/css/bootstrap.min.css HTTP/1.1" 200 12345
[12/Oct/2024 14:32:00] "GET /static/css/style.css HTTP/1.1" 404 1234

如果某条CSS请求返回404，那问题就明了了——要么路径写错了，要么文件本身不存在。

2. 检查路径的大小写问题 #

Django在开发环境下对静态文件路径是严格区分大小写的！比如你模板里写的是css/bootstrap.min.css，但实际文件夹是CSS（大写），或者文件名是Style.css，就会导致部分文件找不到，出现“部分生效”的情况。

3. 清理浏览器缓存 #

当你从“无文件夹结构”改成“有子文件夹”时，浏览器很可能缓存了旧的静态文件路径。试试强制刷新页面：

• Windows/Linux：Ctrl + Shift + R
• Mac：Cmd + Shift + R
  这会强制浏览器重新加载所有静态资源，排除缓存导致的异常。

4. 检查文件/文件夹权限 #

如果是在Linux/macOS环境下，要确认static/css文件夹和里面的CSS文件有被读取的权限。比如可以用命令查看：

ls -l static/css/

如果文件权限是-rw-------（只有所有者能读），那Django的开发服务器可能没法访问它，导致加载失败。可以用下面的命令调整权限：

chmod -R 644 static/css/

5. 排除collectstatic的干扰 #

虽然开发环境下Django默认会直接从STATICFILES_DIRS指定的文件夹读取静态文件，但如果你之前运行过python manage.py collectstatic，staticfiles文件夹里可能残留了旧的无结构静态文件。可以删除staticfiles文件夹，然后重启开发服务器试试。

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