如何在Mule 4中通过ID更新MongoDB文档

问题根源 #

你当前的配置存在两个核心问题：

1. 未区分查询条件和更新内容，直接将完整文档放入content-to-update，不符合MongoDB更新操作的规范。
2. 使用字符串形式的{ "$oid": "..." }表示ObjectId，且错误转义了$符号，导致JSON解析失败。

正确配置示例 #

MongoDB的update-documents组件需要明确拆分查询条件（匹配目标文档）和更新操作（修改指定字段），且需用标准方式构造ObjectId：

<mongo:update-documents doc:name="Update documents" doc:id="01d91a66-6b4f-464f-bac8-47fba99103de" config-ref="MongoDB" collectionName="test">
    <!-- 匹配指定ID的文档 -->
    <mongo:query><![CDATA[#[{ "_id" : new org.bson.types.ObjectId("61aa5bba4b5db6001c7aa333") }]]]></mongo:query>
    <!-- 仅更新指定字段（用$set操作符避免替换整个文档） -->
    <mongo:content-to-update><![CDATA[#[{ "$set" : { "boQuantity" : 1, "ipQuantity": 1 } }]]]></mongo:content-to-update>
</mongo:update-documents>

关键注意事项 #

• 拆分查询与更新：必须通过<mongo:query>指定要更新的文档，<mongo:content-to-update>仅定义修改内容。
• 正确构造ObjectId：使用new org.bson.types.ObjectId("ID字符串")生成合法的ObjectId对象，而非字符串形式的BSON扩展格式。
• 使用$set操作符：该操作符仅修改指定字段，不会覆盖文档中其他未提及的字段，是MongoDB更新的标准用法。
• 无需转义$符号：CDATA块内的MEL表达式中，$作为MongoDB操作符无需转义，之前的"\$oid"写法会导致解析错误。

额外排查点 #

• 确认MongoDB连接器版本与Mule Runtime版本兼容（如Mule 4.x对应MongoDB Connector 4.x系列）。
• 检查config-ref指向的MongoDB连接配置是否有效、可正常连接数据库。
• 确保传入的ID字符串是24位十六进制的有效ObjectId格式。

内容的提问来源于stack exchange，提问作者Jesus Abraham Felix González