distinct() 加了没用是因为数据库对 JOIN 后的主键去重支持不同：MySQL 不支持含 JOIN 的 ORDER BY 后无参 distinct，PostgreSQL 要求排序字段不引发一对多膨胀；应改用 distinct('field')（PG/SQLite）、annotate+聚合或 values().distinct().order_by()。
distinct() 为什么加了没用？
常见现象是写完 Sample.objects.order_by('virus__pathogen_name').distinct()，结果还是看到重复的 Sample 实例。这不是 bug，而是 distinct() 的行为依赖于数据库后端和 order_by 字段是否参与 JOIN。
关键点：MySQL 不支持在含多表 JOIN 的 ORDER BY 后直接用无参 distinct() 去重主键；PostgreSQL 支持，但前提是排序字段不引入“一对多膨胀”。
- 如果只查单表字段（如
Sample.name），.distinct().order_by('name')通常有效 - 一旦
order_by涉及外键反向或正向关联字段（如'virus__pathogen_name'），SQL 会隐式 JOIN，导致distinct对主键失效 - 不加
order_by直接用.distinct()，Django 可能按模型默认排序字段补全，反而让去重逻辑更难预测
用 distinct('field') 指定去重维度
PostgreSQL 和 SQLite 支持带参数的 distinct()，它等价于 SQL 的 SELECT DISTINCT ON (field) —— 每个 field 值只取第一条匹配记录。
例如想按病毒名排序、但每个 Sample 只出现一次：
立即学习“Python免费学习笔记（深入）”；
Sample.objects.order_by('virus__pathogen_name', 'id').distinct('virus__pathogen_name')
注意两点：
-
distinct('virus__pathogen_name')要求order_by的第一个字段必须是它本身或其前缀（如先排virus__pathogen_name，再排id） - MySQL 完全不支持该语法，调用会报错
NotImplementedError - 这个方式本质是“每组取一”，不是“全局去重”，适合你明确要按某个关联字段分组展示首条数据的场景
用 annotate + Min/Max 避免 JOIN 膨胀
当 distinct() 失效且不能换数据库时，绕过 JOIN 是最稳的解法。核心思路：不通过 virus__pathogen_name 排序，而是先聚合出每个 Sample 对应的代表值，再排序。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
比如取每个样本关联病毒中字典序最小的名称：
from django.db.models import Min
Sample.objects.annotate(first_name=Min('virus__pathogen_name')).order_by('first_name')
这样生成的 SQL 不含重复行 JOIN，Sample 自然不重复。但要注意：
-
Min/Max是聚合函数，会强制 GROUP BY 主键，所以结果必然是每个Sample一行 - 如果一个
Sample关联多个病毒，first_name是聚合结果，不代表原始某条病毒记录的完整数据 - 若需保留某条具体病毒的信息（比如最新创建的那条），改用
Subquery+OuterRef更精准，但性能略低
values().distinct() 后必须跟 order_by()
如果你只想要某些字段（如 spu_code）去重后的列表，别直接 .values('spu_code').distinct() —— 这在多数数据库里返回的仍是未真正去重的结果集（尽管 .count() 正确）。
正确写法是显式加 order_by：
GoodsSPU.objects.values('spu_code').distinct().order_by('spu_code')
原因：Django 在生成 SQL 时，distinct() 若无明确排序依据，可能无法稳定决定“哪一行该被保留”。加上 order_by 后，数据库才能确定去重锚点。
容易忽略的一点：这个组合只对 .values() 查询有效；一旦混用 .all() 或模型实例方法，distinct() 就又回到主键层面，和 JOIN 问题重新挂钩。
