Django静态文件本地加载正常但Kubernetes/Nginx部署时缺失问题求助

问题核心原因梳理 #

• collectstatic存储路径矛盾：配置中STATIC_ROOT指定为/ingestion-dashboard/staticfiles，但你反馈执行命令后资源被打包到ingestion-dashboard/dashboard/staticfiles，路径不匹配是核心问题之一
• 排查命令使用错误：你执行的python manage.py findstatic css/volt.css查找路径与实际文件存放路径assets/css/volt.css不符，自然返回找不到结果，正确的排查命令应为python manage.py findstatic assets/css/volt.css
• 部署端静态路由配置缺失：Kubernetes/Nginx环境未正确配置静态资源路由规则

分步解决步骤 #

1. 修正collectstatic路径映射
   先确认settings.py配置是否生效，执行以下命令查看当前生效的静态配置：

python manage.py shell
from django.conf import settings
print(settings.STATIC_ROOT)
print(settings.STATICFILES_DIRS)

如果输出的STATIC_ROOT不是/ingestion-dashboard/staticfiles，检查settings.py是否有后续覆盖该变量的代码，修正后重新执行python manage.py collectstatic --noinput，确认所有静态资源被正确收集到根目录的staticfiles文件夹下。

2. 配置Nginx静态路由
   在Nginx配置文件中添加以下规则，将所有/static/开头的请求直接指向静态资源根目录：

location /static/ {
    alias /ingestion-dashboard/staticfiles/;
    expires 30d;
    add_header Cache-Control "public, immutable";
}

如果Django和Nginx部署在不同的容器中，需要将/ingestion-dashboard/staticfiles目录通过共享持久卷挂载到Nginx容器的对应路径下。

3. 优化模板静态资源引用方式（可选但推荐）
   替换模板中硬编码的静态路径为Django原生static模板标签，避免后续STATIC_URL调整导致引用失效：
   首先在模板顶部加载static标签：

{% load static %}

然后修改资源引用代码：

<script src="{% static 'assets/vendor/@popperjs/core/dist/umd/popper.min.js' %}"></script>

4. Kubernetes部署校验
   如果使用多容器Pod部署，确认Pod的volumes配置正确挂载了静态文件目录，Django容器和Nginx容器都可以读取该目录；如果是单容器部署，确认Nginx服务运行在同一个容器内且路径配置正确。

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