Django Rest序列化器如何返回Base64编码字符串而非图片链接

要让你的序列化器返回Base64编码的图片字符串而不是URL，核心思路是替换默认的图片序列化逻辑——Django REST Framework的ImageField默认返回文件URL，我们需要自定义一个字段来完成图片到Base64的转换。下面是具体实现步骤：

步骤1：导入必要模块 #

先把需要用到的工具模块和序列化基类导入进来：

import base64
from rest_framework import serializers
from .models import modelEmployee
from .serializers import Serializer_ListUser  # 请替换成你的用户序列化器实际路径

步骤2：创建自定义Base64图片字段 #

继承serializers.ImageField，重写to_representation方法来处理编码逻辑：

class Base64ImageField(serializers.ImageField):
    def to_representation(self, value):
        # 先判断图片是否存在，避免空值报错
        if not value or not value.name:
            return None
        
        try:
            # 读取图片文件的二进制内容
            with open(value.path, 'rb') as image_file:
                # 将二进制数据编码为Base64字符串
                base64_str = base64.b64encode(image_file.read()).decode('utf-8')
                # 获取图片的MIME类型（比如image/png、image/jpeg）
                mime_type = value.file.content_type
                # 拼接成前端可直接使用的Base64格式字符串
                return f'data:{mime_type};base64,{base64_str}'
        except Exception as e:
            # 处理文件读取失败的情况，比如文件被删除
            return None

步骤3：修改原有序列化器 #

把原来的employee_image字段替换成我们自定义的Base64ImageField即可：

class Serializer_ListEmployee(serializers.ModelSerializer):
    user = Serializer_ListUser()
    # 替换默认ImageField为自定义Base64字段
    employee_image = Base64ImageField()
    
    class Meta:
        model = modelEmployee
        fields = ['user', 'employee_image']

额外提示 #

• 性能权衡：Base64编码会让图片体积增大约30%，如果你的接口需要返回大量图片，可能会影响响应速度，建议根据业务场景选择是否使用。
• 扩展优化：如果需要支持图片上传时的Base64解码（双向处理），可以在自定义字段里重写to_internal_value方法，实现Base64字符串转图片文件的逻辑。

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