在 java mongodb driver 中，更新操作中字段值若以 `$` 开头（如 `"$300k"`），会被误解析为聚合表达式操作符，导致更新失败；需使用 `$literal` 显式声明其为字面量字符串。
MongoDB 的 Java 驱动（尤其是 4.x+ 版本）在构建更新语句（如 Updates.set()）时，会对传入的值进行上下文感知解析。当值是一个以 $ 开头的字符串（例如 "$300k"、"$name" 或 "$123"），驱动会尝试将其解释为聚合表达式操作符（如 $sum、$concat 等），而非普通字符串字面量。由于 "$300k" 并非合法操作符，解析失败将抛出 IllegalArgumentException 或静默忽略，最终导致更新不生效——这正是你遇到 income 字段无法写入 "$300k" 的根本原因。
✅ 正确做法是：显式包裹为 $literal 表达式，告诉 MongoDB “请将此内容视为原始字符串，不要解析为操作符”。
以下是两种推荐实现方式（均基于 mongodb-driver-sync 4.11+）：
import static com.mongodb.client.model.Filters.eq;
import static com.mongodb.client.model.Updates.set;
import com.mongodb.client.model.UpdateOptions;
import com.mongodb.client.model.Filters;
import com.mongodb.client.model.Updates;
import org.bson.Document;
import java.util.Arrays;
// 方式 1：使用 eq() 作为 $literal 的快捷构造（推荐，语义清晰）
List<Bson> updates = Arrays.asList(
set("income", eq("$literal", "$300k"))
);
// 方式 2：手动构建 Document（等效，更直观）
List<Bson> updates = Arrays.asList(
set("income", new Document("$literal", "$300k"))
);
UpdateOptions options = new UpdateOptions().upsert(true);
Bson filter = Filters.eq("id", 123456);
UpdateResult result = collection.updateOne(filter, updates, options);⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
- $literal 是聚合表达式中的标准操作符，仅在更新/聚合上下文中生效，不可用于 Filters（查询条件）中作为字段值（如 Filters.eq("name", "$literal") 是合法字符串匹配，但 Filters.eq("name", eq("$literal", "abc")) 无意义且不被支持）；
- 不要试图通过转义（如 "\$300k"）解决——BSON 层不识别 Java 字符串转义，$ 符号本身未被转义机制覆盖；
- 若需批量设置多个含 $ 的字符串字段，可复用相同模式，例如：
set("salary", eq("$literal", "$300k")), set("currency", eq("$literal", "$USD")), set("code", eq("$literal", "$ABC123"))
? 总结：MongoDB 驱动对 $ 前缀的“表达式敏感性”是设计使然，旨在支持强大的更新表达式能力（如 set("bonus", "$salary")）。当业务数据本身包含 $ 开头的字符串时，主动使用 $literal 是唯一健壮、符合官方规范的解决方案。这一原则同样适用于其他 MongoDB 官方驱动（如 Node.js 的 {$literal: "$300k"}）。
