Django DRF序列化器ImageField未返回绝对图片链接如何解决

Django REST Framework 默认的ModelSerializer处理ImageField字段时，默认返回媒体文件相对路径，要返回带完整域名端口的可访问绝对链接，按以下步骤配置即可：

1. 配置settings.py基础参数 #

首先确认并修改以下配置项：

• 配置服务访问域名：

# 开发环境填本地服务地址，生产环境替换为正式域名
SITE_DOMAIN = "http://127.0.0.1:8000"

• 配置媒体文件路径规则，和期望的/api/media/前缀对齐：

import os
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')  # 媒体文件实际存储根目录
MEDIA_URL = '/api/media/'  # 媒体文件对外访问的URL前缀

• 确保序列化器实例化时传入request上下文：
  如果是手动实例化序列化器，必须把request对象传入context，否则无法自动拼接域名；如果使用DRF自带的ModelViewSet、ListAPIView等通用视图，框架会自动传入该上下文，无需手动处理。
  手动实例化的正确示例：

# 错误写法：缺失request上下文，只能返回相对路径
# serializer = PictureSerializer(picture_qs, many=True)

# 正确写法
serializer = PictureSerializer(picture_qs, many=True, context={'request': request})

2. 调整序列化器字段逻辑 #

两种实现方式二选一即可：

方式1：手动拼接路径（灵活度最高，适配自定义路径规则） #

使用SerializerMethodField自定义image字段返回值，直接拼接完整链接：

from django.conf import settings
from rest_framework import serializers
from .models import Picture

class PictureSerializer(serializers.ModelSerializer):
    image = serializers.SerializerMethodField()

    def get_image(self, obj):
        if not obj.image:
            return None
        return f"{settings.SITE_DOMAIN}{settings.MEDIA_URL}{obj.image.name}"

    class Meta:
        model = Picture
        fields = ['image']

方式2：使用DRF自带字段自动生成（代码最简洁） #

DRF内置的ImageField序列化字段支持自动基于request上下文拼接绝对路径，直接替换默认字段即可：

from rest_framework import serializers
from .models import Picture

class PictureSerializer(serializers.ModelSerializer):
    image = serializers.ImageField(use_url=True)

    class Meta:
        model = Picture
        fields = ['image']

注意：该方式必须保证序列化器能拿到request上下文，否则依然会返回相对路径。

3. 开发环境配置媒体文件路由 #

开发模式下需要在项目根urls.py中添加媒体文件路由映射，否则生成的链接无法正常访问：

from django.conf import settings
from django.conf.urls.static import static
from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    # 其余业务路由
]

# DEBUG模式下添加媒体文件路由映射
if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

配置完成后重启服务，接口返回的image字段就会是期望的完整绝对链接格式。

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