Django Admin主题切换图标显示异常：白色方块替代图标（Django4.2.1）

• 检查Nginx的SVG MIME类型配置
  Django Admin的主题切换图标是SVG格式，如果Nginx没有正确识别SVG的MIME类型，浏览器会无法解析图标，显示白方块。打开Nginx的配置文件（比如nginx.conf或站点配置文件），确认types块中包含：

types {
    image/svg+xml svg;
}

如果没有，添加后重启Nginx服务。

• 验证静态文件的完整性与权限
  虽然执行了python manage.py collectstatic --noinput，但部署到EC云时可能出现文件传输损坏或权限不足的情况：

  1. 本地对比Docker容器和EC云服务器上static/admin/img/theme-toggle.svg的MD5值，确认文件未损坏；
  2. 确保静态文件及目录的权限正确，Nginx运行用户（通常是www-data）有读取权限，可执行命令：

     chmod -R 644 /path/to/staticfiles/admin/img/
     chmod -R 755 /path/to/staticfiles/admin/
     

• 处理浏览器或Nginx的缓存问题
  旧的损坏图标可能被缓存，导致新文件无法生效：

  1. 在Nginx的静态文件location块中添加缓存控制头，强制浏览器重新校验文件：

     location /static/ {
         expires 1d;
         add_header Cache-Control "public, must-revalidate";
     }
     

  2. 临时修改Django的settings.py中的STATIC_URL，比如改为STATIC_URL = '/static/?v=202501'，通过添加版本参数绕过缓存。

• 确认静态文件路径映射正确
  检查Nginx配置中静态文件的路径映射是否准确，比如：

location /static/ {
    alias /path/to/your/project/staticfiles/;
}

注意alias后的路径末尾要加斜杠，避免路径拼接错误导致Nginx找不到SVG文件。

• 核对Admin静态文件版本匹配
  确保EC云服务器上的Django版本是4.2.1，且collectstatic是基于该版本执行的，避免不同版本的Admin静态文件混合导致路径或资源不匹配。可以检查static/admin/css/base.css中引用theme-toggle.svg的路径是否与实际文件位置一致。

内容的提问来源于stack exchange，提问作者Domenico Spidy Tamburro