配置Django项目上传静态/媒体文件至DigitalOcean Spaces遇故障

问题背景 #

使用Django+Vue开发的社交媒体应用，前端Vercel部署正常，后端部署在DigitalOcean App Platform（关联GitHub仓库）。应用核心功能正常，但用户上传的媒体文件存在异常，且每次部署时python manage.py collectstatic步骤必失败，出现两类典型错误：

1. ?: (staticfiles.W004) The directory '/workspace/backend/static' in the STATICFILES_DIRS setting
2. botocore.exceptions.ClientError: An error occurred (404) when calling the HeadObject operation: Not Found

已尝试调整settings.py静态/媒体配置、更换Spaces存储桶、更新环境变量，但问题未解决。

针对性修复方案 #

1. 解决 staticfiles.W004 目录不存在警告 #

这个错误的核心是STATICFILES_DIRS配置的目录在部署环境中不存在：

• 检查Git提交状态：如果backend/static是项目自定义静态文件目录，确认该目录已被提交到GitHub（空目录需添加.gitkeep文件才能被Git追踪）；如果没有自定义静态文件，直接注释掉STATICFILES_DIRS配置。
• 验证BASE_DIR路径正确性：在settings.py中添加临时打印语句（部署后查看日志）确认BASE_DIR指向：

  import os
  BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
  print(f"BASE_DIR: {BASE_DIR}") # 部署日志中查看实际路径
  

  如果BASE_DIR指向/workspace而非/workspace/backend，则调整STATICFILES_DIRS为：

  STATICFILES_DIRS = [os.path.join(BASE_DIR, 'backend', 'static')]
  

2. 解决 botocore 404 HeadObject 错误 #

这个错误通常是Spaces端点配置、权限或路径拼接错误导致：

• 使用正确的端点URL：不要在AWS_S3_ENDPOINT_URL中包含存储桶名称，应使用区域通用端点：

  AWS_S3_ENDPOINT_URL = 'https://nyc3.digitaloceanspaces.com'
  

  带存储桶名的端点会导致路径重复（如https://rec-room-media.nyc3.digitaloceanspaces.com/rec-room-media/static/...），引发404。
• 验证权限与密钥：确保DigitalOcean Spaces Access Key/Secret Key拥有目标存储桶的读写权限，且在DO App Platform的环境变量中正确配置（无多余空格、引号）。
• 匹配存储桶名称与区域：确认AWS_STORAGE_BUCKET_NAME完全匹配（Spaces桶名仅支持小写），且区域与端点一致（如nyc3对应纽约区域）。
• 简化STATIC_URL配置：无需手动拼接URL，让django-storages自动处理：

  AWS_LOCATION = 'static'
  STATIC_URL = '/static/' # storages会自动映射到Spaces的对应路径
  

3. 适配Django 4.2+的STORAGES配置 #

弃用旧的STATICFILES_STORAGE和DEFAULT_FILE_STORAGE，使用官方推荐的STORAGES配置：

1. 确保自定义MediaStorage类正确实现：

   # backend/storage_backend.py
   from storages.backends.s3boto3 import S3Boto3Storage
   
   class MediaStorage(S3Boto3Storage):
       location = 'media'
       default_acl = 'public-read'
   

2. 在settings.py中配置STORAGES：

   STORAGES = {
       "staticfiles": {
           "BACKEND": "storages.backends.s3boto3.S3Boto3Storage",
           "OPTIONS": {
               "location": "static",
               "default_acl": "public-read",
               "object_parameters": {"CacheControl": "max-age=86400"},
           },
       },
       "default": {
           "BACKEND": "backend.storage_backend.MediaStorage",
       },
   }
   

4. DO App Platform部署额外配置 #

• 强制非交互式collectstatic：在DO App Platform的部署命令中添加--noinput参数：

  python manage.py collectstatic --noinput
  

• 检查环境变量加载：在部署日志中确认所有AWS相关环境变量已正确加载（可临时添加print(os.getenv('AWS_ACCESS_KEY_ID'))验证）。

验证步骤 #

1. 推送修改后的代码到GitHub，触发DO App Platform重新部署。
2. 查看部署日志，确认collectstatic步骤无错误。
3. 登录DigitalOcean Spaces控制台，检查static和media目录下的文件是否正常上传。

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