DEBUG=False时Django静态文件丢失问题求助（DigitalOcean部署）

第一步：先修复collectstatic的文件缺失报错 #

你执行python manage.py collectstatic时找不到assets/js/plugins/gmaps.min.js.map，这是导致staticfiles文件夹无法生成的直接原因，先解决这个：

• 检查项目中是否真的存在这个.map文件：
  • 如果文件不存在，找到引用它的位置（通常是同目录下gmaps.min.js末尾的//# sourceMappingURL=gmaps.min.js.map注释），删掉这行注释即可。
  • 如果这个文件属于第三方依赖包，尝试重新安装依赖：pip install --force-reinstall <对应依赖包名>（比如如果是django-gmaps之类的包）。
• 执行python manage.py collectstatic --noinput，确认命令能成功执行，生成项目根目录的staticfiles文件夹。

第二步：排查WhiteNoise配置与DEBUG=False的500错误 #

解决完collectstatic的问题后，针对ValueError: Missing staticfiles manifest entry for 'images/favicons/favicon.ico'问题，按以下步骤检查：

1. 确认WhiteNoise的核心配置正确 #

检查settings.py中的关键配置项：

• INSTALLED_APPS：确保whitenoise.runserver_nostatic放在最顶部，替代Django默认的runserver静态文件处理：

  INSTALLED_APPS = [
      'whitenoise.runserver_nostatic',
      'django.contrib.staticfiles',
      # 你的其他应用
  ]
  

• MIDDLEWARE：WhiteNoiseMiddleware必须放在SecurityMiddleware之后，CommonMiddleware之前：

  MIDDLEWARE = [
      'django.middleware.security.SecurityMiddleware',
      'whitenoise.middleware.WhiteNoiseMiddleware',  # 关键位置
      'django.contrib.sessions.middleware.SessionMiddleware',
      'django.middleware.common.CommonMiddleware',
      # 其他中间件
  ]
  

• 静态文件基础配置：

  STATIC_ROOT = BASE_DIR / 'staticfiles'  # 对应collectstatic生成的文件夹
  STATIC_URL = '/static/'
  # 使用带manifest的存储类（DEBUG=False时必须）
  STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
  

2. 确保静态文件引用正确 #

• 模板中引用favicon.ico时，必须使用Django的static模板标签，不能硬编码路径：

  <link rel="icon" href="{% static 'images/favicons/favicon.ico' %}" type="image/x-icon">
  

• 确认你的应用静态文件目录（比如your_app/static/）下确实存在images/favicons/favicon.ico，collectstatic会把它复制到staticfiles目录中。

3. DigitalOcean App平台的构建配置 #

在DO App的Build & Deploy设置中，确保构建命令包含collectstatic步骤：

pip install -r requirements.txt && python manage.py collectstatic --noinput

这一步会在部署前自动收集静态文件到staticfiles目录，确保WhiteNoise能读取到。

额外排查技巧 #

• 本地模拟生产环境：在本地设置DEBUG=False，运行python manage.py runserver，复现问题后直接查看本地的staticfiles目录和manifest.json，更容易定位问题。
• 临时放宽manifest检查：如果紧急需要上线，可以在settings.py中添加WHITENOISE_MANIFEST_STRICT = False，但这只是临时方案，最终还是要修复缺失的静态文件或引用问题。

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