hint() 只在查询层生效且不绕过索引过滤器，必须在游标构建阶段调用，需严格匹配复合索引字段顺序与方向，受索引过滤器限制，Spring Data 中用 withHint() 设置 Document 类型提示。
能强制，但必须清楚它只在查询层生效，且不会绕过索引过滤器逻辑。 MongoDB 的 hint() 是调试和临时干预手段，不是索引调度的“开关”。
hint() 必须用在游标上，不能直接加在 find() 返回结果后
常见错误是写成 db.users.find({age: {$gt: 25}}).hint({age: 1}).toArray() —— 看似合理，但 hint() 必须在游标构建阶段调用，否则会被忽略。mongosh 中正确顺序是：
db.users.find({age: {$gt: 25}}).hint({age: 1}).toArray()- 或链式调用：
db.users.find().hint({age: 1}).filter({age: {$gt: 25}}).toArray()（注意filter()是客户端过滤，不推荐） - 复合索引要严格匹配字段顺序和方向：比如索引是
{user_id: 1, order_time: -1}，hint 就得写成.hint({user_id: 1, order_time: -1})，写成{user_id: 1, order_time: 1}可能被拒绝或降级为全表扫描
使用 $hint 时 explain() 要放在同一查询结构里
当用老式写法 db.users.find({$query: {age: {$gt: 25}}, $hint: {age: 1}})，就不能再额外加 .explain() 链式调用。必须把 $explain 放进同一个文档：
db.users.find({
$query: {age: {$gt: 25}},
$hint: {age: 1},
$explain: "executionStats"
})
否则会报错 unrecognized field '$explain'。新写法（.hint().explain()）更直观，推荐优先使用。
hint() 在有索引过滤器（index filter）时会被完全忽略
MongoDB 允许为集合设置索引过滤器（通过 planCacheSetFilter），一旦设置了，所有对该集合的查询都会被约束在过滤器定义的索引范围内。此时无论你传什么 hint()，只要不在过滤器白名单里，就会被静默丢弃——explain() 的 queryPlanner.winningPlan 里也看不到 hint 生效痕迹。
- 检查是否存在过滤器：
db.runCommand({planCacheListFilters: "users"}) - 清除过滤器：
db.runCommand({planCacheClearFilters: "users"}) - 索引过滤器是 server 端策略，比客户端
hint()优先级更高
Java Spring Data MongoDB 怎么传 hint？
Spring Data MongoDB 的 Query 对象不直接暴露 hint() 方法，但可通过 withHint() 设置：
Query query = new Query(Criteria.where("age").gt(25));
query.withHint(new Document("age", 1));
mongoTemplate.find(query, User.class, "users");
注意两点：
-
withHint()接收的是Document，不是字符串索引名（区别于 shell 中可传字符串如"age_1"） - 如果该索引不存在，驱动不会报错，但执行计划里会显示
stage: "COLLSCAN"，务必结合explain()验证
真正容易被忽略的点是：hint 不解决索引设计缺陷。比如你对 {status: 1, created_at: -1} 强制 hint，但查询只用了 status，而没带 created_at 条件，那复合索引的后半段就浪费了——这时应该建一个单字段索引，而不是靠 hint 硬撑。
