Django REST Framework序列化器ImageField返回完整URL及utf-8错误解决

1. 你直接返回productos.imagen时，该字段是Django的ImageFieldFile实例，JSON序列化器会尝试读取其关联的二进制图片文件内容转为字符串，图片二进制数据不符合UTF-8编码规则，因此触发解码错误。
2. 使用str(productos.imagen)时，实际调用了ImageFieldFile的__str__方法，仅返回文件的相对存储路径，不会拼接域名和MEDIA_URL前缀，因此只能拿到半截路径。
3. 初始状态下DRF默认的ImageField序列化逻辑会自动读取字段的.url属性，并且依靠视图传入的request上下文拼接完整域名，所以能返回完整URL，你重写to_representation后绕过了这套默认逻辑。

方案1（推荐）：复用DRF默认序列化逻辑 #

不用手动构造全部返回字段，先调用父类的to_representation方法拿到默认序列化结果（包含自动生成的完整图片URL），再补充分类信息即可，同时还能避免多余的数据库查询：

def to_representation(self, obj):
    # 调用父类方法获取默认序列化结果，保留图片URL自动生成逻辑
    data = super().to_representation(obj)
    # 直接通过外键获取关联分类信息，无需额外查询数据库
    data['Categorias'] = {
        "id_categoria": obj.id_categoria.id_categoria,
        "categoria": obj.id_categoria.categoria,
        "fecha": obj.id_categoria.fecha
    }
    # 如需修改字段名可在此调整，比如将原id_productos改为id_producto
    data['id_producto'] = data.pop('id_productos')
    return data

该方案无需修改其他代码，默认保留DRF的所有字段处理逻辑，性能更高也不易出错。

方案2：手动获取完整图片URL #

如果你坚持要手动构造返回字典，直接读取ImageFieldFile的url属性即可，注意做空值判断避免图片为空时报错：

return{
    # 其他字段不变
    "imagen": obj.imagen.url if obj.imagen else None,
    # 其他字段不变
}

注意需确保序列化器初始化时传入了request上下文（DRF通用视图会默认传，自定义视图需手动加context={'request': request}参数），否则生成的URL不会携带域名前缀。

你原代码中to_representation方法内的两次数据库查询是完全多余的：

• productos = Productos.objects.get(id_productos=obj.id_productos)：参数obj本身就是当前要序列化的Productos实例，直接使用即可，无需重复查询。
• categorias = Categoria.objects.get(productos=obj.id_productos)：Productos模型中id_categoria是外键，直接通过obj.id_categoria就能拿到关联的分类实例，无需额外查询。

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