Django项目中decimal.Decimal与float执行减法运算偶发类型错误问题

报错根因 #

1. 核心代码逻辑存在类型混用问题：你主动将Decimal类型的registration_tokens转为float，再和Decimal类型的admin_wallet_balance做算术运算，而Python 3.10以下版本原生不支持Decimal和float类型的加减操作，这是报错的基础原因。
2. 偶发触发的原因：
   • 所有DecimalField的default参数传入的是float类型的0.00，而非标准Decimal类型。当字段使用默认值且未执行过数据库写入/刷新操作时，Django ORM可能直接返回你传入的原始float值，而非转换后的Decimal值，触发类型冲突。
   • 如果你项目开启了模型层缓存，Decimal类型在序列化时会默认转为float存储，读取出来后就是float类型，也会触发冲突。
   • 不同部署环境的Python版本差异，会导致同一段代码在高版本Python（3.10+支持Decimal和float运算）的应用中正常运行，在低版本环境中偶发报错。

解决方案 #

第一步：修正模型字段默认值 #

将所有DecimalField的默认值改为Decimal类型，避免默认值的类型冲突：

from decimal import Decimal

# 所有DecimalField按以下示例修改
class BarterAdminWallet(models.Model):
    admin_wallet_id = models.BigAutoField(primary_key=True)
    admin_wallet_balance = models.DecimalField(max_digits=60, decimal_places=2, default = Decimal('0.00'))
    admin_tokens_assigned = models.DecimalField(max_digits=60, decimal_places=2, default = Decimal('0.00'))
    admin_tokens_earned = models.DecimalField(max_digits=60, decimal_places=2, default = Decimal('0.00'))
    admin_tokens_bought = models.DecimalField(max_digits=60, decimal_places=2, default = Decimal('0.00'))

# BarterAdminActionsTokens的所有DecimalField也同步修改default为Decimal('0.00')

修改完成后执行python manage.py makemigrations和python manage.py migrate同步数据库变更。

第二步：移除不必要的float转换 #

运算全程使用Decimal类型，不要做强制float转换：

admin_actions = BarterAdminActionsTokens.objects.get()
registration_tokens = admin_actions.account_activation_tokens

admin_wallet = BarterAdminWallet.objects.get()
# 直接使用Decimal做算术运算
admin_wallet.admin_wallet_balance = admin_wallet.admin_wallet_balance - registration_tokens
admin_wallet.admin_tokens_assigned = admin_wallet.admin_tokens_assigned + registration_tokens
admin_wallet.save()

token_status.user_account_activation_token_status = "Awarded"
token_status.save()

第三步：缓存场景兼容（可选） #

如果你的项目使用了模型缓存，在序列化/反序列化时明确保留Decimal类型，或者在运算前增加强制转换逻辑，兜底避免类型异常：

from decimal import Decimal
# 运算前强制转换为Decimal，兼容缓存返回float的场景
registration_tokens = Decimal(str(registration_tokens))

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