Django外键关联场景下按联赛名过滤运动队数据的查询异常问题

问题根因 #

你之前写的查询语句完全踩中了Django外键查询的常见坑，两个异常现象的成因分别是：

• 执行filter(league='MLB')报错：league是绑定League模型的外键字段，当你直接把外键名作为筛选条件时，Django默认只接受关联模型的主键值（也就是League表自增生成的id），传入字符串'MLB'不符合主键的整数类型要求，因此系统提示需要传入关联League模型的主键。
• 执行filter(league=3)返回空结果：这个语法本身是合法的，但你根本没有核对MLB对应的League记录实际的主键是多少，靠猜测填的3根本不是MLB记录的id，自然匹配不到任何球队数据。

补充说明：你遍历全量球队时能正常打印出对应的联赛名称，是因为访问球队关联的league属性时，ORM会自动按需查询关联表的数据完成取值，这个运行时的取值逻辑，不能替代正确的查询集筛选语法——为了筛MLB的球队每次把全量数据拉到内存循环判断，性能也扛不住。

修正实现 #

推荐写法：双下划线跨表查询 #

Django原生支持通过双下划线语法穿透外键，直接拿关联表的字段做筛选，完全不需要手动记MLB对应的League主键是多少，直接替换表单初始化里的筛选代码就行：

# 原有错误代码
team_names = TeamName.objects.filter(league='MLB')

# 修正后：通过双下划线关联League表的name字段做筛选
team_names = TeamName.objects.filter(league__name='MLB')

备选写法：先取联赛实例再筛选 #

如果你习惯先拿到联赛对象再做关联，也可以先查询到MLB对应的League实例，直接把实例作为外键查询条件（ORM会自动提取实例的主键完成匹配）：

mlb_league = League.objects.get(name='MLB')
team_names = TeamName.objects.filter(league=mlb_league)

两种写法最终生成的SQL逻辑完全一致，实际开发中优先用第一种跨表语法即可，ORM会自动做查询优化，不会产生多余的数据库开销。

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