Rust中MongoDB的$or查询findOne失效问题排查

出现这种情况的可能原因及解决步骤如下：

可能原因 #

1. 查询计划选择异常：MongoDB处理多条件$or查询时，可能选择了不恰当的索引策略，比如优先使用第二个无匹配结果的条件索引，导致未扫描到目标文档。
2. Rust MongoDB驱动隐性bug：部分旧版本驱动在解析多条件$or查询结果时存在问题，会过滤掉原本匹配的文档。
3. 生成的查询BSON存在隐性错误：虽然代码语法正确，但doc!宏可能生成了不符合预期的BSON结构（比如ObjectId赋值错误、字段类型不匹配）。

解决步骤 #

1. 验证生成的查询BSON #

打印查询的BSON结构，确认两个条件的ObjectId值和字段名是否与目标文档匹配：

let query = doc! {
    "$or": [
        {
            "initiator": user,
            "target": target,
        },
        {
            "initiator": target,
            "target": user,
        }
    ],
};
println!("Generated query: {}", serde_json::to_string_pretty(&query).unwrap());

对比输出的ObjectId与目标文档中的initiator/target值，确保变量赋值完全正确。

2. 在MongoDB Shell中直接执行查询 #

将打印出的BSON转换为Shell命令，直接在数据库中执行，验证查询逻辑本身是否有效：

db.friends.findOne({
    "$or": [
        {
            "initiator": ObjectId("你的user变量值"),
            "target": ObjectId("你的target变量值")
        },
        {
            "initiator": ObjectId("你的target变量值"),
            "target": ObjectId("你的user变量值")
        }
    ]
})

如果Shell中能查到目标文档，说明问题出在Rust驱动层面；如果查不到，则需检查数据库索引或查询逻辑。

3. 查看查询执行计划 #

使用explain()选项查看MongoDB的查询计划，确认索引使用和文档扫描情况：

use mongodb::options::{FindOneOptions, ExplainOptions};

let options = FindOneOptions::builder()
    .explain(ExplainOptions::default())
    .build();

let explain_result = db.auto_collection::<Friend>()
    .find_one(query, options)
    .await?;

println!("Query plan: {}", serde_json::to_string_pretty(&explain_result).unwrap());

检查计划中是否扫描到了目标文档，以及使用的索引是否正确。

4. 升级Rust MongoDB驱动 #

如果使用的是旧版本驱动，尝试升级到最新稳定版，修复可能存在的已知bug：
修改Cargo.toml中的依赖：

mongodb = "2.8.0" # 替换为最新稳定版本
bson = "2.8.0"

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