Django Forms部分字段initial值不生效：ID冲突排查与解决

问题描述 #

在使用Django ModelForm时，设置initial初始值后，address、latitude、longitude三个字段始终无法显示初始值，其他字段均正常填充。打印default_values字典确认所有值都正确，尝试移除并重新添加这三个字段后问题依旧。

相关代码 #

表单代码 #

class OrderForm(forms.ModelForm):
    class Meta:
        model = Order
        fields = ['first_name', 'last_name', 'cpf', 'phone', 'email', 'address', 'street_name', 'street_number', 'address_complement', 'country', 'state', 'city', 'pin_code', 'latitude', 'longitude',]

视图代码 #

default_values = {
    'first_name': request.user.first_name,
    'last_name': request.user.last_name,
    'cpf': request.user.cpf,
    'phone': request.user.phone_number,
    'email': request.user.email,
    'address': checkout_address.address,
    'street_name': checkout_address.street_name,
    'street_number': checkout_address.street_number,
    'address_complement': checkout_address.address_complement,
    'country': checkout_address.country,
    'state': checkout_address.state,
    'city': checkout_address.city,
    'pin_code': checkout_address.pin_code,
    'latitude': checkout_address.latitude,
    'longitude': checkout_address.longitude
}
form = OrderForm(initial=default_values)

验证过的initial值 #

{'first_name': 'Admin', 'last_name': 'Sistemas', 'cpf': '9999999', 'phone': '98989898', 'email': 'rm@rm.com', 'address': 'Rua dos Lamentos, 10, Armação dos Búzios - RJ', 'street_name': 'R. dos Lamentos', 'street_number': '10', 'address_complement': 'ap32', 'country': 'Brasil', 'state': 'Rio de Janeiro', 'city': 'Armação dos Búzios', 'pin_code': '28950-000', 'latitude': '-22.7980796', 'longitude': '-41.9321335'}

Order模型代码 #

class Order(models.Model):
    user = models.ForeignKey(User, on_delete=models.SET_NULL, null=True)
    order_address = models.CharField(max_length=200, blank=True, null=True)
    order_street_name = models.CharField(max_length=200, blank=True, null=True)
    order_street_number = models.CharField(max_length=10)
    order_address_complement = models.CharField(max_length=100, blank=True, null=True)
    order_country = models.CharField(max_length=100, blank=True, null=True)
    order_city = models.CharField(max_length=100, blank=True, null=True)
    order_state = models.CharField(max_length=100, blank=True, null=True)
    order_pin_code = models.CharField(max_length=100, blank=True, null=True)
    order_latitude = models.CharField(max_length=20, blank=True, null=True)
    order_longitude = models.CharField(max_length=20, blank=True, null=True)

问题根源 #

核心问题是Django表单字段ID与Google Autocomplete的ID需求冲突：

• Google Autocomplete脚本依赖ID为id_address、id_latitude、id_longitude的输入框进行交互
• Django ModelForm会自动为模型字段生成id_<字段名>的ID，同时表单中声明的字段名（address）与模型实际字段名（order_address）不匹配，导致initial值无法正确映射到对应字段，ID冲突进一步干扰了字段的渲染与赋值流程。

已验证的解决方案 #

为模型字段添加order_前缀（如order_address、order_latitude），确保表单字段与模型字段正确关联，解决ID冲突后，initial值即可正常填充到对应字段。

其他可行方案 #

除了重命名模型字段，还有以下几种灵活的解决思路：

1. 自定义表单字段的ID #

无需修改模型，直接在表单中为字段指定自定义ID，匹配Google Autocomplete的需求：

class OrderForm(forms.ModelForm):
    address = forms.CharField(widget=forms.TextInput(attrs={'id': 'address'}))
    latitude = forms.CharField(widget=forms.TextInput(attrs={'id': 'latitude'}))
    longitude = forms.CharField(widget=forms.TextInput(attrs={'id': 'longitude'}))

    class Meta:
        model = Order
        fields = ['first_name', 'last_name', 'cpf', 'phone', 'email', 'address', 'street_name', 'street_number', 'address_complement', 'country', 'state', 'city', 'pin_code', 'latitude', 'longitude']

2. 修改Google Autocomplete的选择器 #

调整Google Autocomplete的初始化代码，使用类选择器代替ID匹配，避免全局ID冲突：

// 替换原有的getElementById为类选择器
autocomplete = new google.maps.places.Autocomplete(
    document.querySelector('.address-input'),
    { types: ['geocode'] }
);

同时在表单字段的widget中添加对应类名：

address = forms.CharField(widget=forms.TextInput(attrs={'class': 'address-input'}))

3. 使用表单prefix参数 #

如果页面存在多个表单或需要避免ID冲突，给表单添加prefix参数：

form = OrderForm(initial=default_values, prefix='order')

此时表单字段的ID会变为order-address，只需同步调整Google Autocomplete的目标ID即可。

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