Wagtail CMS从Staging复制到生产环境后媒体文件夹恢复异常求助

首先帮你理清一个关键概念：python manage.py collectstatic是用来收集静态文件（比如站点的CSS、JS、主题资源这些）到指定目录的，而你遇到的是用户上传的媒体文件（Wagtail里的图片、文档）不显示的问题，这俩完全是两码事，所以这个命令不是你当前问题的核心，先不用纠结它。

下面是一步步排查和解决的思路：

1. 确认媒体文件的核心配置是否正确 #

先检查你的Wagtail项目settings.py里的两个关键配置：

• MEDIA_ROOT：这是服务器上存储媒体文件的绝对路径，要确保你复制的媒体文件夹完全放到了容器内的这个路径下。
• MEDIA_URL：这是前端访问媒体文件的URL前缀（比如/media/），要确保Web服务器（比如Nginx、Django自带的runserver）能正确处理这个前缀的请求，指向MEDIA_ROOT的文件。

举个例子，如果你的MEDIA_ROOT是/app/media/，那你复制的所有图片文件必须放在容器内的/app/media/目录下，层级结构要和数据库里记录的一致。

2. 排查Docker容器的媒体文件持久化问题 #

因为Docker容器本身是临时的，如果你只是手动把媒体文件夹复制到运行中的容器里，下次容器重启（比如CodeBuild构建新容器部署）这些文件就会丢失。所以正确的做法是：

• 使用**Docker卷（Volume）**把媒体文件夹挂载到容器外的持久化存储（比如AWS EBS、EFS），这样不管容器怎么重启或重建，媒体文件都能保留。
• 更推荐的是在AWS环境下，把Wagtail的媒体存储后端配置为AWS S3，直接让Wagtail把上传的图片存到S3桶里，这样完全不需要依赖容器内的文件系统，也避免了容器部署时的文件同步问题。

3. 验证文件权限与容器运行用户 #

你已经修改了文件夹的所有者和组，但要确认容器运行的用户（比如很多Django Docker镜像用www-data或者django用户）是否对媒体文件夹有读取权限：

• 进入容器执行ls -l /path/to/media/，查看文件的所有者和权限位（比如是否有r权限）。
• 如果权限不足，可以在Dockerfile里添加命令设置权限，比如：

  RUN chown -R www-data:www-data /app/media/
  RUN chmod -R 755 /app/media/
  

  或者在启动容器时用--user指定有权限的用户。

4. 检查数据库与文件路径的一致性 #

Wagtail的图片在数据库的wagtailimages_image表中存储了文件的相对路径（对应file字段），你需要确认这个相对路径和你复制的媒体文件的实际路径完全匹配：

• 比如数据库里记录的是images/2024/05/10/test.jpg，那你的媒体文件夹里必须有images/2024/05/10/test.jpg这个文件，路径层级不能错。
• 如果开发环境和生产环境的媒体路径结构有差异，就会导致数据库里的路径找不到对应的文件。

5. 测试Web服务器的媒体路由配置 #

如果你用了Nginx之类的反向代理，要确保配置里有处理MEDIA_URL的路由规则：
比如Nginx里要加这样的location块：

location /media/ {
    alias /app/media/; # 对应容器内的MEDIA_ROOT路径
    expires 30d;
}

如果直接用Django的runserver测试（不推荐生产环境用），要确保在urls.py里配置了媒体文件的路由：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # 你的其他路由
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

6. 快速测试方法 #

可以进入容器内，用curl命令直接访问图片的本地路径，比如：

curl http://localhost:8000/media/images/2024/05/10/test.jpg

如果返回图片内容，说明文件存在且Django能正确处理；如果返回404，那要么文件路径不对，要么配置有问题。

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