PyMongo的sort()方法只接受形如[('field', 1), ('field', -1)]的元组列表，方向值必须为1或-1，不支持字符串、缺省或额外元素；多字段排序严格按列表顺序执行，空值默认最小，未索引字段排序性能差。
sort() 方法不接受元组列表，传入会报错
MongoDB 的 PyMongo 驱动中，sort() 方法**从不接受元组列表**（如 [('name', 1), ('age', -1)] 是合法的，但 [('name', 1), ('age', -1), ...] 这种写法本身没问题，问题在于有人误以为可以传 [('name', 1, 'asc'), ...] 或嵌套元组）。真正常见错误是：把 Python 的 sorted() 习惯迁移到 PyMongo，试图传 [('field', ASC), ('field', DESC)] 以外的结构，比如字典列表、带关键字的元组、或漏写方向值。
正确形式只能是 list of (field_name, direction)，其中 direction 必须是 1（升序）或 -1（降序）——不能是字符串 'asc'、'descending'，也不能省略。
- ✅ 正确：
[('price', -1), ('category', 1)] - ❌ 报错：
[('price', 'desc'), ('category', 'asc')]→TypeError: second element of each item must be 1 or -1 - ❌ 报错：
[('price', -1, 'ignore')]→ValueError: too many values to unpack
多个字段排序的实际执行顺序就是列表顺序
PyMongo 按你传入的 list 从左到右依次排序：先按第一个字段分组，组内再按第二个字段排序，依此类推。这和 SQL 中 ORDER BY a DESC, b ASC 完全一致，不是“同时比较”或加权排序。
例如查询商品，希望“优先按销量降序，销量相同时按上架时间升序”，就得写成：
collection.find().sort([('sales_count', -1), ('created_at', 1)])
如果反过来写成 [('created_at', 1), ('sales_count', -1)]，结果会先按时间排，再在每个时间点内按销量排——完全不符合业务意图。
- 字段顺序不能靠“猜”，必须严格对应业务优先级
- 方向值写错（比如该
-1写成1）会导致排序结果肉眼难察觉的翻转，尤其当数据分布不均时 - 对未索引字段多级排序，性能会明显下降；建议在常用排序组合上建复合索引，如
db.collection.create_index([('sales_count', -1), ('created_at', 1)])
空值（None / null）和缺失字段的排序行为要主动验证
MongoDB 默认把 null 和缺失字段视为**最小值**，所以在升序（1）时它们总排最前，降序（-1）时总排最后。这和 PostgreSQL/MySQL 不同（后者可配 NULLS FIRST/LAST），PyMongo 无法干预。
如果你的文档里 rating 字段可能缺失，又想让有评分的排前面，就不能只靠 [('rating', -1)]——因为缺失项会被垫底，反而混在高分后面。
- 稳妥做法：用
$exists+$ne过滤，或用聚合管道$addFields补默认值 - 临时 workaround：加一个辅助字段，如
has_rating: {'$cond': [{'$gt': [{'$type': '$rating'}, 'missing']}, 1, 0]}，再按[('has_rating', -1), ('rating', -1)]排 - 直接依赖默认行为的风险：前端展示时发现“无评分”商品突然出现在列表顶部，排查时容易忽略这个隐式规则
聚合管道中的 $sort 支持更灵活的表达式，但代价是不能用索引加速
如果真需要按计算值排序（比如按价格打 9 折后排序），或者想控制 null 位置，就得放弃 find().sort()，改用聚合管道：
collection.aggregate([
{'$addFields': {'discounted_price': {'$multiply': ['$price', 0.9]}}},
{'$sort': {'discounted_price': -1}}
])
注意：$sort 阶段**无法利用索引**（除非整个 pipeline 能被优化为 find + sort），大数据集下延迟明显。而且聚合返回的是 CommandCursor，不是 Cursor，不支持 limit() 链式调用（得写进 $limit 阶段）。
- 简单多字段静态排序，死守
find().sort(list) - 只要涉及字段运算、条件判断、或
null精细控制，立刻切聚合，别硬扛 - 聚合里
$sort的键名是字符串（如'rating'），不是元组，别和find().sort()的语法混淆
实际写的时候，最容易被忽略的是字段顺序与业务语义的对齐，以及空值在多级排序中的“静默下沉”。这两点不提前验证，上线后往往要翻日志、导数据、人工比对才能定位。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
