Django中如何将存储整数的CharField按数值类型过滤查询集

问题根源 #

CharField的大小比对基于字符串字典序完成，和数值大小逻辑完全不一致，例如字符串'999'在字典序中会大于'1000'，完全不符合薪资数值过滤的预期。

方案一：长期最优解，调整模型字段类型
如果项目未上线或可接受数据迁移，直接将CharField替换为IntegerField是最彻底的方案：

• 修改模型字段定义，兼容原有空值场景：

salary_amount_min = models.IntegerField(null=True, default=None)
salary_amount_max = models.IntegerField(null=True, default=None)

• 提前清洗存量数据：如果原有字段中存在非数字格式的内容（例如“面议”这类文本），需先将这类值更新为NULL，避免迁移报错。
• 执行Django数据迁移，迁移完成后原有过滤逻辑无需修改，直接使用salary_amount_min__gte这类查询即可正常按数值比对。

方案二：不修改模型，查询时动态做类型转换
如果无法调整现有模型（例如已上线无法执行结构迁移），可以在查询时通过数据库函数将字符串字段动态转为整数类型，再做数值比对，适配主流数据库（PostgreSQL、MySQL、SQLite）的语法规范。

依赖导入 #

from django.db.models import IntegerField, Value
from django.db.models.functions import Cast, NullIf

核心转换逻辑 #

先构造转换表达式，把原有CharField的空字符串、NULL值统一处理后转成整数类型，避免转换时报错：

# 将字符串格式的最小薪资转成整数，自动把空字符串转为SQL NULL
salary_min_as_int = Cast(
    NullIf('salary_amount_min', Value('')),
    output_field=IntegerField()
)
# 最大薪资字段同理转换
salary_max_as_int = Cast(
    NullIf('salary_amount_max', Value('')),
    output_field=IntegerField()
)

调整过滤逻辑 #

先确保表单返回的搜索值为整数类型（建议在表单中把搜索薪资字段设为IntegerField，避免传入字符串），再基于转换后的整数表达式构造过滤条件：

# 获取清洗后的整数类型搜索值
search_salary_min = hr_form.cleaned_data['search_salary_min']
search_salary_max = hr_form.cleaned_data['search_salary_max']

# 适配可选搜索条件，仅当用户输入对应值时才拼接过滤规则
salary_filter = Q()
if search_salary_min is not None:
    salary_filter &= Q(salary_min_as_int__gte=search_salary_min)
if search_salary_max is not None:
    salary_filter &= Q(salary_max_as_int__lte=search_salary_max)

# 最终应用过滤到查询集
queryset = queryset.filter(salary_filter)

如果需要复用转换后的整数字段，也可以先通过annotate把转换结果映射为普通字段，再做过滤：

queryset = queryset.annotate(
    salary_min_int=salary_min_as_int,
    salary_max_int=salary_max_as_int
).filter(
    salary_min_int__gte=search_salary_min,
    salary_max_int__lte=search_salary_max
)

注意事项 #

• 动态类型转换逻辑会下推到数据库执行，不会在Python层处理，无性能瓶颈，仅比原生整数字段查询略有损耗，适合临时过渡场景。
• 该语法支持Django 1.8及以上的所有版本，无特殊版本依赖。
• 如果存量数据中存在非数字格式的脏数据，会导致转换失败报错，需要提前完成数据清洗。
• 避免给搜索值传入字符串类型，否则会出现整数和字符串比对的类型错误。

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