Django用户模型更新异常：含字母手机号未校验且被截断

核心原因 #

你使用的PhoneNumberField（通常来自django-phonenumber-field库）底层依赖Google的libphonenumber库，它的解析逻辑是：

• 自动过滤掉号码中的非数字、非允许符号（仅保留+、-、空格等少数符号），所以输入的字母a会被直接截断清除。
• 验证时只针对清理后的纯数字+合法符号的字符串进行格式校验，自然会通过验证，不会触发无效提示。

验证流程拆解 #

当提交带字母的手机号时：

1. 表单接收POST数据后，PhoneNumberField的字段清洗（clean）方法会先调用phonenumbers.parse()解析号码。
2. 解析过程中，libphonenumber自动移除所有非号码字符（包括字母），得到+0043328107这样的合法格式。
3. 验证逻辑只检查清洗后的号码是否符合国际号码规范，因此判定为有效，不会抛出验证错误。

解决办法 #

如果需要严格禁止号码中出现字母等非法字符，需要在表单或字段层面添加额外的自定义校验：

方法1：在自定义表单中添加字段级校验 #

修改你的CustomUserChangeForm，给phone_number字段添加自定义验证逻辑：

from django import forms
from phonenumber_field.formfields import PhoneNumberField
from .models import CustomUser

class CustomUserChangeForm(forms.ModelForm):
    phone_number = PhoneNumberField()

    def clean_phone_number(self):
        phone = self.cleaned_data.get('phone_number')
        # 获取原始输入的手机号（未被清洗的原始POST数据）
        raw_phone = self.data.get('phone_number')
        # 检查原始输入是否包含非数字、非允许符号的字符
        allowed_chars = set('+0123456789 -')
        if not all(char in allowed_chars for char in raw_phone):
            raise forms.ValidationError("手机号只能包含数字、+、-和空格")
        return phone

    class Meta:
        model = CustomUser
        fields = ('phone_number', ...)

方法2：自定义PhoneNumberField子类（全局复用） #

如果多个表单都需要这个校验，可以自定义字段类，全局复用：

from phonenumber_field.modelfields import PhoneNumberField as BasePhoneNumberField
from django.core.exceptions import ValidationError

class StrictPhoneNumberField(BasePhoneNumberField):
    def clean(self, value, model_instance):
        # 先验证原始输入的字符合法性
        allowed_chars = set('+0123456789 -')
        if value and not all(char in allowed_chars for char in str(value)):
            raise ValidationError("手机号只能包含数字、+、-和空格")
        # 再调用父类的清洗逻辑
        return super().clean(value, model_instance)

然后在CustomUser模型中使用这个自定义字段：

from django.contrib.auth.models import AbstractUser
from .fields import StrictPhoneNumberField

class CustomUser(AbstractUser):
    phone_number = StrictPhoneNumberField(unique=True)

补充说明 #

• 如果你是自行实现的PhoneNumberField而非使用第三方库，问题大概率出在字段清洗逻辑中——没有先校验原始输入的字符范围，直接做了格式解析和清理。
• libphonenumber的设计初衷是宽容解析（允许用户输入带分隔符、空格的号码），所以默认不会拦截字母这类非法字符，需要手动添加严格校验。

内容的提问来源于stack exchange，提问作者l.diazborg