Django REST Framework：为URL字段自动补全缺失的Scheme

方案一：自定义模型字段（全局生效） #

Django的URLField会在模型验证（包括clean/save方法执行）之前调用to_python方法做值转换与初步校验，因此直接在模型层自定义字段，重写to_python补全Scheme，能从根源解决问题，且对所有使用该模型的场景（DRF接口、Django Admin等）生效。

代码实现：

from django.db import models

class AutoSchemeURLField(models.URLField):
    def to_python(self, value):
        # 仅对非空且无Scheme的URL补全https://
        if value and not value.startswith(('http://', 'https://')):
            value = f'https://{value}'
        # 调用父类方法完成后续转换与校验
        return super().to_python(value)

class MyModel(models.Model):
    url = AutoSchemeURLField()

方案二：DRF序列化器层面处理（仅API生效） #

如果只需要在DRF接口中实现该逻辑，无需影响其他场景，可以在序列化器的字段验证方法中处理：

代码实现：

from rest_framework import serializers
from django.core.validators import URLValidator
from django.core.exceptions import ValidationError
from .models import MyModel

class MyModelSerializer(serializers.ModelSerializer):
    def validate_url(self, value):
        # 补全Scheme
        if value and not value.startswith(('http://', 'https://')):
            value = f'https://{value}'
        # 手动触发URL校验
        validator = URLValidator()
        try:
            validator(value)
        except ValidationError as e:
            raise serializers.ValidationError(str(e))
        return value

    class Meta:
        model = MyModel
        fields = '__all__'

为什么之前的clean/save方法无效？ #

Django的URLField校验流程是：先通过to_python转换值，再执行内置的URL校验，最后才会调用模型的clean/clean_fields方法。如果在clean中修改字段值，此时已经触发了URL校验错误，所以无法生效。

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