Django中DecimalField搭配Select组件使用的异常问题排查

模型、配置及表单代码如下：

# models.py
from django.db import models

class ObjectModel(models.Model):
    object = models.DecimalField(max_digits=10, decimal_places=2)

# my_settings.py
from decimal import Decimal 

object_choices = [
    (Decimal('1'),'1'),
    (Decimal('1.5'),'1.5'),
    (Decimal('2'),'2'),
    (Decimal('2.5'),'2.5'),
    (Decimal('3'),'2.5'),  # 注：此处选项键与显示文本不匹配，建议修正
]

# forms.py
from django import forms
from my_settings import object_choices
from models import ObjectModel

class ObjectForm(forms.ModelForm):
    object = forms.ChoiceField(choices = object_choices)
    class Meta:
        model = ObjectModel
        fields = ['object']

表单渲染、保存数据均正常，但使用form = ObjectForm(instance = obj)加载编辑表单时，Select组件无法显示初始值；删除表单中object字段定义，使用默认文本输入框则显示正常。已尝试TypedChoiceField、在__init__中设置初始值、DecimalField搭配Select组件，均未解决问题。

解决方案 #

核心问题是ChoiceField默认会将选项的键转换为字符串，而模型中存储的是Decimal类型，两者类型不匹配导致无法匹配选中项。以下是两种有效解决方式：

方式一：使用TypedChoiceField并指定coerce参数 #

TypedChoiceField支持将提交的值转换为指定类型，同时渲染时会自动处理类型匹配：

# forms.py
from django import forms
from decimal import Decimal
from my_settings import object_choices
from models import ObjectModel

class ObjectForm(forms.ModelForm):
    object = forms.TypedChoiceField(
        choices=object_choices,
        coerce=Decimal  # 指定将提交的字符串转换为Decimal类型，匹配实例中的Decimal值
    )
    class Meta:
        model = ObjectModel
        fields = ['object']

方式二：将choices的键改为字符串类型 #

表单提交时传递的是字符串，将选项的键改为字符串后，模型中的Decimal值会被自动转换为字符串进行匹配：

# my_settings.py
object_choices = [
    ('1','1'),
    ('1.5','1.5'),
    ('2','2'),
    ('2.5','2.5'),
    ('3','3'),  # 修正原代码中键值不匹配的问题
]

此时表单中使用普通ChoiceField即可：

# forms.py
class ObjectForm(forms.ModelForm):
    object = forms.ChoiceField(choices = object_choices)
    class Meta:
        model = ObjectModel
        fields = ['object']

额外注意 #

原my_settings.py中最后一个选项的键是Decimal('3')，但显示文本是'2.5'，属于配置错误，建议修正为键值对应，避免逻辑混乱。

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