Django 1.11.x升级至2.x后Group by字段异常及QuerySet结果差异问题

最近把Django从1.11.x版本升级到2.x后，我没碰应用里的任何模型和业务代码，结果QuerySet返回的结果居然跟之前不一样了。打印生成的SQL语句一看，发现Group by子句里指定的字段完全不符合预期，这可把我搞懵了。

相关模型定义 #

class Content(models.Model):
    id_field = models.AutoField(db_column='id_', primary_key=True)
    # 省略其他字段
    collections = models.ManyToManyField('Collection', through='CollectionMap', through_fields=('contentid', 'collectionid'))

class CollectionMap(models.Model):
    field_index = models.AutoField(db_column='...')  # 原内容字段定义未完整，核心为多对多关联中间表
    # 补充常规关联字段示例：
    # contentid = models.ForeignKey(Content, db_column='content_id', on_delete=models.CASCADE)
    # collectionid = models.ForeignKey(Collection, db_column='collection_id', on_delete=models.CASCADE)

问题原因分析 #

这其实是Django版本升级后，QuerySet分组逻辑的变化导致的：

• Django 1.11对Group by的处理相对宽松，会自动根据模型字段的db_column映射生成SQL，甚至会自动推断分组字段；但2.x版本更严格遵循SQL标准，同时对自定义主键、多对多中间表的字段映射逻辑做了调整。
• 你的Content模型用了自定义主键id_field并指定db_column='id_'，升级后Django生成Group by子句时，可能直接使用模型字段名id_field，而非映射到数据库实际列名id_，导致SQL执行时分组字段错误。
• 多对多关联的中间表CollectionMap如果有自定义db_column，2.x版本对关联字段的解析逻辑也和1.11不同，容易出现分组字段不匹配的情况。

解决办法 #

• 显式指定分组字段：在使用annotate()或values()做分组查询时，明确指定要分组的数据库列名或正确的模型字段关联路径。比如原来的查询如果是：

  Content.objects.annotate(collection_count=Count('collections')).values('id_field')
  

  可以改成直接指定数据库列名：

  Content.objects.annotate(collection_count=Count('collections')).values('id_')
  

• 调整模型主键定义（若业务允许）：把Content模型的主键字段名改成和db_column一致，比如：

  id = models.AutoField(db_column='id_', primary_key=True)
  

  这样Django生成SQL时就不会出现字段名与数据库列名不匹配的问题。
• 检查多对多中间表字段：确保CollectionMap里的contentid和collectionid字段正确指定db_column，且与数据库实际列名一致。分组查询时可显式关联中间表字段，比如：

  Content.objects.annotate(collection_count=Count('collections')).values('id_field', 'collectionmap__contentid')
  

• 遵循新版分组规则：Django 2.x对annotate()和values()的组合使用有更严格要求，需明确指定分组字段，不能依赖1.11的自动推断逻辑。

内容的提问来源于stack exchange，提问作者Dawoon Daniel Kang