Django中distinct方法失效：无法获取季度与年份的唯一配对

看起来你遇到的问题是明明用了distinct()，但还是得到重复的period_quarter和period_year组合。这种情况通常有几个常见原因，我来一步步帮你排查和解决：

1. 检查是否存在默认排序（ordering）干扰 #

Django的distinct()行为会和查询中的排序字段绑定——如果你的DataValue模型在Meta类里设置了ordering（比如按id排序），或者你在查询前调用了order_by()，那么distinct()会把排序字段也纳入去重判断范围。即使你只values()了两个字段，Django也会偷偷把排序字段加进查询，导致因为排序字段不同（比如每条记录的id不同），返回看起来重复的配对。

解决方案：显式清空排序，在查询中加上order_by()（不带参数）：

DataValue.objects.values('period_quarter', 'period_year').order_by().distinct()

2. 排查数据本身的隐式差异 #

有时候看起来完全一样的字符串，实际可能包含不可见字符（比如空格、制表符）或者大小写差异（比如Q2和q2），数据库会把它们判定为不同的值，导致distinct()无法去重。

验证方法：直接用SQL查询数据库，看看真实结果：

SELECT DISTINCT period_quarter, period_year FROM your_app_datavalue;

如果SQL查询也返回重复项，那肯定是数据本身的问题。

解决方案：

• 清理字段的前后空格：

  from django.db.models.functions import Trim
  
  DataValue.objects.update(
      period_quarter=Trim('period_quarter'),
      period_year=Trim('period_year')
  )
  

• 统一大小写（如果需要不区分大小写的去重）：

  from django.db.models.functions import Lower
  
  # 先获取去重后的小写组合，再映射回原格式（或者直接用小写结果）
  unique_pairs = DataValue.objects.annotate(
      quarter=Lower('period_quarter'),
      year=Lower('period_year')
  ).values('quarter', 'year').distinct()
  

3. 数据库特定的DISTINCT行为差异 #

如果使用的是MySQL，它不支持PostgreSQL那种distinct(*fields)的语法（只针对特定字段去重），但只要你没有额外的排序字段干扰，且数据本身无差异，values().distinct()应该能正常工作。如果还是有问题，可以尝试用distinct()配合values_list()，或者直接用raw()执行原生SQL：

unique_pairs = DataValue.objects.raw('SELECT DISTINCT period_quarter, period_year FROM your_app_datavalue')

先从第一种情况排查（默认排序干扰），这是最常见的原因，很多人都会忽略模型里的默认ordering设置。如果解决了，那最好；如果没解决，再检查数据本身的问题。

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