UpdateOne 未更新文档最常见原因是 filter 不匹配，需检查 MatchedCount 和 ModifiedCount；务必用 $set 等操作符而非直接赋值；确认字段名、类型一致，优先用 struct 或 bson.D；注意 Go driver 版本与 WriteConcern 配置。
UpdateOne 为什么没更新到任何文档？
最常见原因是 filter 条件不匹配，MongoDB 找不到对应文档。它不会报错，只会返回 MatchedCount: 0 和 ModifiedCount: 0 —— 你得主动检查这个结果，而不是默认“执行了就成功”。
- 确认
filter中的字段名和类型完全一致（比如"_id"是ObjectID类型，不能传字符串） - 用
FindOne先查一遍，验证文档是否存在、结构是否符合预期 - 避免直接写
map[string]interface{}{"name": "foo"}，优先用 struct +bson.M或bson.D明确键序（尤其涉及嵌套或数组操作时）
update 参数里该用 $set 还是直接写字段？
必须用 $set（或其他更新操作符），不能把新值直接塞进 map 顶层。MongoDB 的 update 操作不是“覆盖整个文档”，而是“对字段做原子操作”。
- 正确：
bson.M{"$set": bson.M{"status": "done", "updated_at": time.Now()}} - 错误：
bson.M{"status": "done", "updated_at": time.Now()}→ 这会触发“替换整个文档”，且丢失其他字段 - 如果要删字段，用
$unset；要递增数值，用$inc；要往数组追加，用$push
UpdateOne 返回的 ModifiedCount 为 0 但 MatchedCount 是 1？
说明文档找到了，但新旧值完全一样，MongoDB 认为“无需修改”。这不是 bug，是设计行为 —— 它只在实际变更字段内容时才计数。
- 常见于时间戳未强制刷新（比如重复用同一个
time.Now()变量）、状态字段赋相同值 - 若业务上要求“无论是否变化都记一次操作”，可在
$set中加一个无意义字段（如"_touch": time.Now()） - 注意：
Upsert: true不影响此逻辑，它只在没匹配时插入，不影响已存在文档的修改判断
Go driver 版本差异导致的坑
v1.11+ 默认启用 WriteConcern，但老代码可能依赖旧版宽松行为。升级后突然发现超时或报错，大概率是写入确认策略变了。
立即学习“go语言免费学习笔记（深入）”；
- 检查
mongo.Connect时是否设置了WriteConcern: writeconcern.New(writeconcern.WMajority()) - 本地开发可临时降级为
writeconcern.W1()，但别在生产环境关掉确认 -
context.WithTimeout必须传给UpdateOne，否则网络卡住会无限等待
MatchedCount 和 ModifiedCount 差异——这两个数字不看，等于没验结果。 
