Django本地点击API返回的图片URL提示404 not found该如何排查？

• 第一步：确认DEBUG配置
  首先检查settings.py中DEBUG参数是否为True，你当前的media路由规则仅在DEBUG开启时生效，若DEBUG为关闭状态，本地环境也无法直接访问media资源。
• 第二步：修正MEDIA_ROOT路径
  你当前生效的MEDIA_ROOT = os.path.join(os.path.dirname(BASE_DIR),"media")会将media文件夹生成在项目根目录的上级目录，大概率超出了Django服务的可访问路径范围，换回你注释掉的配置即可：

  MEDIA_ROOT = os.path.join(BASE_DIR,'media')
  

  修改完成后手动在项目根目录创建media文件夹，赋予读写权限。
• 第三步：验证文件上传结果
  配置修改完成后重新在管理后台上传一张图片，进入media文件夹确认对应图片文件是否存在。如果文件不存在，排查上传时的权限问题、模型字段配置问题；如果文件存在，手动拼接地址http://本地服务地址/media/对应文件名直接访问，验证是否可正常打开。
• 第四步：检查序列化器上下文传递
  你在序列化器中使用了request.build_absolute_uri生成绝对路径，需要在视图调用序列化器时传入request上下文，示例如下：

  # 视图中调用序列化器的代码需要带context参数
  serializer = MenusSerializer(menu_obj, context={"request": request})
  

  如果未传上下文，生成的URL前缀会异常，导致访问404。
• 第五步：补全序列化器空值判断
  当前序列化器未处理图片为空的情况，若某条菜单数据没有上传图片，调用obj.image.url会触发异常，建议补充判断：

  def get_image_url(self, obj):
      if not obj.image:
          return ""
      request = self.context.get('request')
      return request.build_absolute_uri(obj.image.url)
  

Heroku环境说明 #

Heroku的文件系统是临时性的，所有上传到Dyno本地的文件都会在Dyno重启、部署新版本时被清空，且Heroku本身不支持托管media文件，若需要在Heroku环境正常使用图片上传功能，需要对接第三方云存储服务。

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