Django外键查询报错：Related Field got invalid lookup: contains

问题描述 #

在添加首页搜索功能时，部分模型字段可正常查询，但使用ForeignKey类型的assign_to_trainer字段进行查询时，触发错误："Related Field got invalid lookup: contains"。

错误原因 #

assign_to_trainer是关联Trainer模型的ForeignKey字段，直接对该字段使用__contains查找是不支持的——__contains是针对字符串/文本类型字段的模糊匹配规则，而ForeignKey字段指向的是模型对象，无法直接用该规则进行匹配。

解决方案 #

根据你的需求，分两种场景修改查询逻辑：

场景1：按教练ID精确匹配（对应HTML中传递的assign_to_trainer_id） #

你的HTML表单传递的是教练ID值，此时应该用精确匹配而非__contains（__contains会匹配包含该数字的所有ID，比如输入1会匹配1、11、21等，不符合预期）：

修改views.py中的filter语句：

trainers_info = Training_Lead.objects.filter(
    start_date__gte=start_date,
    end_date__lte=end_date,
    lead_status__contains=lead_status,
    assign_to_trainer_id=assign_to_trainer,  # 精确匹配教练ID
)

如果你的select是多选（multiple属性），需要用getlist获取多个ID并使用__in匹配：

# 先获取多选的ID列表
assign_to_trainer = request.POST.getlist("assign_to_trainer")
trainers_info = Training_Lead.objects.filter(
    start_date__gte=start_date,
    end_date__lte=end_date,
    lead_status__contains=lead_status,
)
# 若有选中的教练ID，再添加筛选条件
if assign_to_trainer:
    trainers_info = trainers_info.filter(assign_to_trainer_id__in=assign_to_trainer)

场景2：按教练名称模糊匹配 #

如果需求是根据教练名称进行模糊搜索，需要通过双下划线关联到Trainer模型的trainer_name字段：

修改views.py中的filter语句：

trainers_info = Training_Lead.objects.filter(
    start_date__gte=start_date,
    end_date__lte=end_date,
    lead_status__contains=lead_status,
    assign_to_trainer__trainer_name__contains=assign_to_trainer,  # 模糊匹配教练名称
)

关键说明 #

• 对ForeignKey字段进行查询时，必须明确指定关联模型的具体字段（如__id、__trainer_name），不能直接对关联对象使用文本类查找规则。
• assign_to_trainer_id是Django自动为ForeignKey生成的ID字段，和assign_to_trainer__id写法等价。

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