从Django 1.11迁移至2.0时查询引擎报错求助

你遇到的这个问题确实和Django 2.0查询引擎的子查询处理逻辑变更有关——虽然官方发布说明没有直接把这个错误作为迁移点单独强调，但Django 2.0对子查询的列数校验做了更严格的规范，这是导致你在1.11中正常的代码在2.0报错的核心原因。

核心变化：子查询列数的严格校验 #

在Django 1.11中，如果你写了一个返回多列的子查询，框架会隐式忽略多余列（通常只取第一列）来适配场景；但从2.0开始，Django会严格检查子查询的列数是否符合上下文要求，一旦发现多列就直接抛出ProgrammingError，避免了隐式行为带来的潜在逻辑错误。

常见触发场景及修复方案 #

1. 使用Subquery注解时返回多列

比如你可能写过这样的代码：

# Django 1.11会隐式取id列，但2.0直接报错
user_subquery = User.objects.filter(id=OuterRef('user_id')).values('id', 'username')
MyModel.objects.annotate(user_info=Subquery(user_subquery))

修复方式：确保子查询只返回需要的单列，调整values为单个字段：

user_subquery = User.objects.filter(id=OuterRef('user_id')).values('username')
MyModel.objects.annotate(user_name=Subquery(user_subquery))

如果确实需要多列数据，可以用JSONAgg把多列打包成JSON对象，或者用Concat拼接成字符串，再作为单列返回。

2. Exists子查询返回多列

Django 2.0正式内置了Exists表达式（1.11通常需要自定义实现），而Exists只需要判断子查询是否存在，不需要返回具体列。如果你写了这样的代码：

# 错误：返回多列触发报错
exists_subquery = User.objects.filter(id=OuterRef('user_id')).values('id', 'email')
MyModel.objects.filter(Exists(exists_subquery))

修复方式：移除多余的列，甚至不需要values，直接保留查询集即可：

# 正确写法：Exists只检查存在性，无需返回列
exists_subquery = User.objects.filter(id=OuterRef('user_id'))
MyModel.objects.filter(Exists(exists_subquery))

3. __in过滤条件中使用多列子查询

当你用__in做过滤时，子查询必须返回单列。比如：

# 1.11会隐式用id列，但2.0报错
MyModel.objects.filter(user_id__in=User.objects.filter(is_active=True).values('id', 'username'))

修复方式：明确指定子查询返回单列：

MyModel.objects.filter(user_id__in=User.objects.filter(is_active=True).values('id'))

排查建议 #

1. 先定位触发错误的具体测试用例，找到对应的查询代码；
2. 打印查询的SQL语句（用query.__str__()方法），对比Django 1.11和2.0生成的SQL差异；
3. 全局搜索代码中的Subquery、Exists、values()（配合子查询使用的场景），逐一检查列数是否符合要求。

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