insertoneasync不报错但数据未写入，主因是未await导致任务未完成、写关注配置为w=0、连接未就绪或集合名错误；find查不到数据常因bson字段名与c#属性名不匹配。
为什么 InsertOneAsync 有时不报错但数据没写入？
常见现象是调用成功、返回 InsertOneResult，但去 MongoDB Shell 或 Compass 查不到文档。根本原因通常是连接未真正就绪，或写关注（WriteConcern）配置被忽略。
- 默认情况下
MongoClient使用WriteConcern.Acknowledged，但若连接字符串里带?w=0（比如测试环境误配），写操作会“火发即忘”，失败也不通知 - 异步调用未
await，导致主线程退出、MongoClient被提前释放（尤其在控制台程序中） - 集合名拼写错误或数据库不存在且
createCollection未启用 —— MongoDB 不会自动建库建集，只静默写入到“不存在的”目标
建议始终显式检查 result.IsAcknowledged，并在初始化时加一句 await client.ListDatabaseNames().ToListAsync() 验证连通性。
Find 查询为什么查不到明明存在的数据？
最常踩的坑不是语法错，而是 BSON 序列化与字段名不匹配。MongoDB 存储的是 snake_case 字段（如 restaurant_id），而 C# 类属性默认是 PascalCase（RestaurantId）。
- 不加映射时，驱动会按属性名序列化，结果存成
{"RestaurantId": "123"}，但原始数据是{"restaurant_id": "123"}，查询自然失效 - 正确做法是在属性上加
[BsonElement("restaurant_id")]，或全局注册ConventionPack处理命名转换 - 使用
Builders<t>.Filter</t>构造查询时，必须基于类定义的字段路径，不能直接写 BSON 字段名（例如Eq("restaurant_id", "123")仅在无类型Find<bsondocument></bsondocument>中有效）
更新嵌套数组元素该用 UpdateOneAsync 还是 ReplaceOneAsync？
二者语义完全不同：ReplaceOneAsync 是整文档替换，会丢掉所有未包含在对象中的字段；UpdateOneAsync 才是局部更新，适合改数组中某一项。
- 要更新数组中第一个匹配的元素，用
Set+ElemMatch：Builders<restaurant>.Update.Set("grades.$[g].score", 95)</restaurant>配合ArrayFilters指定g.grade == "A" - 若误用
ReplaceOneAsync，即使只传了部分字段，也会把Address、Borough等其他字段清空为null - 注意：数组过滤器（
ArrayFilters）从 MongoDB 3.6+ 支持，驱动 v2.19+ 才完整封装，旧版需手动构造BsonDocument
删除操作后 DeletedCount 为 0，但 IsAcknowledged 是 true
这说明命令已送达服务器并执行完毕，只是没匹配到任何文档 —— 不是错误，而是预期行为。但开发者常误以为“删失败”。
-
DeleteManyAsync返回的DeleteResult.DeletedCount是唯一可靠判断依据，IsAcknowledged只表示网络和权限没问题 - 如果本应删到却返回 0，优先检查过滤条件是否用了错误的字段名或类型（例如用
int匹配 BSONObjectId字符串） - 调试时可先用
Find+ 相同 filter 跑一遍，确认数据真实存在且结构匹配
真正容易被忽略的是：驱动不会帮你做类型推导。一个 ObjectId 字段，你传 "507f1f77bcf86cd799439011" 字符串进去，它不会自动转成 ObjectId 实例 —— 必须显式调用 new ObjectId(idString)。
