Django Serializer字段验证函数未触发问题排查

问题根源 #

你遇到的问题是因为**serializers.URLField会优先于自定义的validate_url方法执行自带的URL格式验证**。当传入不带http://或https://前缀的字符串时，URLField的默认验证逻辑直接判定格式无效并抛出400错误，导致你的自定义验证代码根本没有执行的机会。

解决方案 #

将url字段的类型从URLField改为CharField，绕过默认的URL验证，然后在自定义的validate_url方法中完成前缀补全和格式验证的逻辑：

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

class StoredCredentialSerializer(serializers.ModelSerializer):
    # 替换为CharField，避免默认验证提前拦截
    url = serializers.CharField()

    class Meta:
        model = StoredCredential
        fields = ['user_id', 'title', 'username', 'password', 'url']

    def validate_url(self, value):
        validator = URLValidator()
        # 先补全缺失的前缀
        if not value.startswith(('http://', 'https://')):
            value = 'http://' + value
        
        # 验证补全后的URL格式
        try:
            validator(value)
        except ValidationError:
            raise serializers.ValidationError("Invalid URL format")
        
        return value

说明 #

修改后，所有传入的URL会先检查并补全前缀，再进行格式验证：

• 如果原URL不带前缀，自动添加http://后验证
• 如果补全前缀后仍然不符合URL格式，才抛出验证错误

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