本文介绍如何在 django 中不硬编码字段名，而是通过变量（如字符串形式的字段名）动态构建 filter 查询条件，适用于运行时才确定模型字段、需灵活组合多条件过滤的场景。
本文介绍如何在 django 中不硬编码字段名，而是通过变量（如字符串形式的字段名）动态构建 filter 查询条件，适用于运行时才确定模型字段、需灵活组合多条件过滤的场景。
在 Django 开发中，常遇到需要根据用户输入或配置动态指定查询字段的场景——例如，前端传入字段名 "username" 和值 "alice"，后端需执行类似 User.objects.filter(username="alice") 的操作，但字段名 username 是字符串变量，无法直接写成 filter(field_name=value)。此时若强行拼接字符串或使用 raw()，不仅破坏 ORM 安全性，还无法链式调用、难以复用已有 QuerySet。
✅ 正确做法是利用 Python 的字典解包（**kwargs）机制，将字段名与值构造成字典，再传递给 .filter()：
# 假设用户输入
field_name = "email" # 字段名（字符串）
field_value = "test@example.com"
# 动态构造查询参数字典
filter_kwargs = {field_name: field_value}
# 应用于任意模型的 QuerySet（支持链式调用）
users = User.objects.all()
filtered_users = users.filter(**filter_kwargs) # 等价于 .filter(email="test@example.com")
该方式可无缝集成到多条件、多模型场景中。例如，根据用户提交的多个字段动态过滤：
Django Unfold
下载
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
# 模拟用户传入的过滤规则
filters = [
{"field": "is_active", "value": True},
{"field": "date_joined__year", "value": 2023},
{"field": "profile__city", "value": "Beijing"},
]
queryset = User.objects.all()
for rule in filters:
# 构建带双下划线的查找字段（如 date_joined__year）
lookup_key = rule["field"]
lookup_value = rule["value"]
queryset = queryset.filter(**{lookup_key: lookup_value})
# 最终结果为：User.objects.filter(is_active=True, date_joined__year=2023, profile__city="Beijing")
⚠️ 注意事项：
- 字段名必须是模型真实存在的字段（含关系字段和查找表达式，如 name__icontains），否则会抛出 FieldError；建议配合 model._meta.get_field() 或白名单校验做安全校验；
- **kwargs 解包仅适用于单个键值对；若需 OR 查询，请改用 Q 对象；
- 此方法完全兼容 QuerySet 的惰性执行与链式调用，不会触发额外数据库查询，也支持 .exclude()、.get() 等其他查询方法；
- 避免直接拼接 SQL 或使用 extra()/raw()——它们绕过 ORM 校验，易引发注入风险且无法复用已有过滤逻辑。
总结：通过 filter(**{field_name: value}) 实现字段名动态化，是 Django 中安全、高效、符合 ORM 设计哲学的标准实践，适用于管理后台、API 过滤器、低代码配置等需要高度灵活性的业务场景。
