Wagtail站点前端图片突然无法渲染 常规排查无效求调试思路

• 第一步排查浏览器请求状态
  打开浏览器控制台「网络」面板，筛选「Img」类请求，查看图片资源的返回状态码：
  • 若返回403：优先排查media目录的访问权限，包括Web服务器（Nginx/Apache）对media目录的访问规则、Wagtail图片服务视图的权限配置，确认是否存在未授权拦截
  • 若返回404：核对settings.py中MEDIA_URL、MEDIA_ROOT配置是否和实际图片存放路径、img标签生成的src前缀一致，确认是否存在路径前缀配置错误、路由冲突覆盖的问题
  • 若返回200但资源为空/内容异常：排查是否有中间件提前终止了media资源请求、图片renditions生成逻辑异常
• 第二步排查Wagtail图片渲染逻辑
  直接复制页面生成的img标签src地址，单独在浏览器地址栏访问验证资源可访问性：
  • 确认media目录下renditions文件夹是否存在、对应缩略图文件是否生成、Web运行用户是否具备该目录的读权限
  • 检查近期是否修改过Wagtail图片后端配置，确认是否误切换为远程存储（如S3）但未完成权限配置，或自定义图片处理逻辑存在报错
• 第三步排查安全策略拦截
  查看浏览器控制台是否存在Content-Security-Policy(CSP) 相关报错，确认是否近期新增了安全中间件或Web服务器安全头配置，CSP规则中的img-src字段未放开media资源的加载权限
• 第四步排查依赖与中间件变动
  • 对比问题出现前后的依赖版本清单，确认wagtail、Pillow等图片处理相关依赖是否发生版本更新，可回滚到此前正常运行的版本验证
  • 临时注释所有自定义中间件、逐个启用排查，确认是否存在自定义逻辑拦截media请求的情况
• 第五步排查路由配置优先级
  检查根urls.py中media路由的配置顺序，确认media路由没有被优先级更高的其他路由规则覆盖，参考配置格式如下：

  from django.conf import settings
  from django.conf.urls.static import static
  
  urlpatterns = [
      # ... 其他路由配置
  ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
  

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