本文详解 mgo 驱动中 $inc 更新失效的常见原因：Go 结构体字段标签（bson tag）与数据库实际字段名不一致导致增量操作静默失败。

本文详解 mgo 驱动中 `$inc` 更新失效的常见原因：go 结构体字段标签（`bson` tag）与数据库实际字段名不一致导致增量操作静默失败。

在使用 mgo 操作 MongoDB 时，$inc 是最常用的原子递增操作符之一，常用于统计类场景（如文章浏览量、点赞数等）。但许多开发者会遇到“代码无报错、数据却未更新”的问题——这往往并非逻辑错误，而是 结构体字段的 BSON 序列化映射不匹配 所致。

以博客浏览计数为例，你的 Go 结构体定义如下：

type Blog struct {
    ID          bson.ObjectId `bson:"_id,omitempty"`
    Topic       string        `bson:"topic"`      // 显式指定 bson 字段名
    TimeCreated string        `bson:"time_created"`
    Views       int           `bson:"views"`      // ✅ 关键：必须显式声明 bson:"views"
    Sections    []Section     `bson:"sections"`
}

⚠️ 注意：Go 字段名 Views 是大写（导出字段），但默认情况下 mgo 不会自动将驼峰命名转为小写 snake_case；若未显式指定 bson tag，mgo 会使用字段名原样（即 "Views"）作为 BSON 键。而你的 MongoDB 文档中实际存储的是 "views": 0（全小写），因此执行：

change := bson.M{"$inc": bson.M{"Views": 1}} // ❌ 匹配文档中不存在的键 "Views"

MongoDB 会尝试对 "Views" 字段加 1，但该字段不存在，于是静默创建并设为 1；而你的 Go 结构体反序列化时仍读取 "views"，导致前端看到的 Views 值始终不变——表面“未更新”，实则更新了错误字段。

✅ 正确做法是：确保 $inc 中的字段名与 BSON 存储名完全一致，且与结构体 bson tag 严格对应：

// 正确：字段名与 bson tag 一致（均为 "views"）
change := bson.M{"$inc": bson.M{"views": 1}}

// 同时务必为结构体字段添加明确的 bson tag
Views int `bson:"views"`

? 进阶建议：

• 始终为所有需持久化的结构体字段显式声明 bson tag，避免依赖默认行为；
• 使用 mgo.Change 配合 Upsert() 可实现更安全的原子更新；
• 开发期可通过 mongo shell 或 Compass 直接检查集合文档真实字段名，验证映射一致性。

总结：mgo 的 $inc 不工作，90% 源于 BSON 键名不匹配。请牢记——Go 字段名 ≠ BSON 字段名，bson tag 才是唯一真相。