Django中Float字段过滤失效问题及正确实现方式咨询

问题场景 #

尝试从MySQL数据库中获取记录时，仅用user_id过滤能正常返回结果，但添加value（Float类型）条件后抛出DoesNotExist异常。Python中user.value为0.4，数据库中对应字段存储值也显示为0.4，但就是无法匹配到记录。

模型定义：

class Record(models.Model):
    user_id = models.IntegerField()
    value = models.FloatField()

class User(models.Model):
    value = models.FloatField()

查询代码：

Record.objects.get(
    user_id=user.id,
    value=user.value
)

问题根源 #

这是浮点数的精度特性导致的：Python里的float和MySQL的float都属于二进制浮点数，存储和计算过程中会存在微小的精度丢失（比如0.4实际存储的可能是0.4000000059604645或0.3999999910593033）。表面上都是0.4，但实际存储的二进制值并不完全相等，因此直接用等值匹配会失败。

正确的过滤方式 #

1. 改用DecimalField（推荐） #

直接替换模型中的FloatField为DecimalField，它是精确的十进制类型，能从根源上避免精度丢失问题：

class Record(models.Model):
    user_id = models.IntegerField()
    value = models.DecimalField(max_digits=10, decimal_places=2)  # 根据实际业务调整参数

class User(models.Model):
    value = models.DecimalField(max_digits=10, decimal_places=2)

修改后直接用等值匹配即可，精度完全一致，不会出现匹配失败的情况。

2. 对FloatField使用范围查询（兼容现有数据） #

如果无法修改模型字段类型，可以通过设置一个极小的误差范围来匹配近似值：

epsilon = 1e-9  # 极小的误差值，可根据精度需求调整
Record.objects.get(
    user_id=user.id,
    value__gte=user.value - epsilon,
    value__lte=user.value + epsilon
)

只要数据库中的值和目标值的差异在误差范围内，就能匹配成功。

3. 转换为字符串匹配（不推荐，仅作补充） #

如果数据库中存储的浮点数格式固定，也可以将Python中的值转为字符串后匹配，但这种方式依赖数据库的字符串转换逻辑，稳定性较差：

Record.objects.get(
    user_id=user.id,
    value=str(user.value)
)

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