Java MongoDB驱动无法更新以$开头的值？原因及解决方法

原因 #

在MongoDB的更新语法规则里，以$开头的字符串会被默认识别为内置操作符（比如$set、$inc这类用于修改文档的指令）。当你通过Updates.set("income", "$300k")传递值时，驱动会误把$300k当成一个更新操作符去解析，而不是普通的字符串字面量，这就导致更新逻辑异常，无法正确设置字段值。

解决方法 #

这里提供三种可行的解决方式：

方式一：用$literal操作符明确指定字面量 #

通过$literal告诉MongoDB，传入的内容是普通字符串而非操作符：

UpdateOptions options = new UpdateOptions().upsert(true);
Bson filters = Filters.eq("id", 123456);

// 使用$literal包裹目标字符串
Bson setIncome = Updates.set("income", new Document("$literal", "$300k"));
UpdateResult updateResult = mongoExe.updateOne(filters, setIncome, options);

方式二：直接构建BsonDocument定义更新操作 #

手动构造Bson结构，绕过驱动的自动解析逻辑：

UpdateOptions options = new UpdateOptions().upsert(true);
Bson filters = Filters.eq("id", 123456);

// 直接创建BsonDocument，明确指定值为BsonString类型
Bson update = new BsonDocument("$set", new BsonDocument("income", new BsonString("$300k")));
UpdateResult updateResult = mongoExe.updateOne(filters, update, options);

方式三：直接传入BsonString类型值（驱动4.0+适用） #

如果你的MongoDB驱动版本在4.0及以上，可以直接把值包装成BsonString传入，避免驱动误解析：

UpdateOptions options = new UpdateOptions().upsert(true);
Bson filters = Filters.eq("id", 123456);

List<Bson> bsonArrayList = new ArrayList<>();
// 用BsonString包装以$开头的字符串
bsonArrayList.add(Updates.set("income", new BsonString("$300k")));

UpdateResult updateResult = mongoExe.updateOne(filters, bsonArrayList, options);

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