Django中File类型对象如何转为JSON可序列化格式

触发报错：

TypeError: Object of type File is not JSON serializable

根本原因 #

JSON仅支持序列化字符串、数字、布尔值、字典、列表、None这类基础数据类型，当前代码直接将django.core.files.base.File文件实例放入响应结构，Django的JSON序列化器无法处理该类型，因此抛出异常。
另外原代码存在一处笔误：第三个try块重复读取other_image2.file，逻辑上应该对应第三个图片字段。

修复方案 #

无需手动转换File对象，直接返回图片的可访问URL字符串即可。Django的ImageField/FileField内置.url属性，调用后直接返回文件的访问路径，为字符串类型，可正常被JSON序列化。
修正后代码：

user = User.objects.get(id=token_data['user_id'])
all_posts = publicPost.objects.filter(user_id=user)
post_ids = [post.id for post in all_posts]
images = {}

for post_id in post_ids:
    img_instance = PostImage.objects.filter(post_id=post_id).first()
    if not img_instance:
        images[post_id] = []
        continue
    # 不再读取.file属性，直接取.url获取图片访问地址
    img_list = [img_instance.image.url]
    # 遍历其余图片字段，避免重复写try/except块，同时修复原代码重复取other_image2的笔误
    for field in [img_instance.other_image1, img_instance.other_image2, img_instance.other_image3]:
        try:
            img_list.append(field.url)
        except ValueError:
            # 字段未上传文件时会触发ValueError，直接跳过
            pass
    images[post_id] = img_list

return JsonResponse({'posts': post_ids, 'images': images})

配置校验 #

• 确认项目settings.py中已正确配置MEDIA_URL与MEDIA_ROOT参数
• 开发环境下需要在根路由文件中添加media路径的路由映射，否则返回的图片URL无法正常访问
• 若文件存储在第三方对象存储服务，.url属性会自动返回对应公网访问地址，无需额外适配

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