如何编写JSON强制MongoDB生成BinData subtype 4类型_id

三种写法未得到预期BinData subtype 4的原因：

• 直接传入UUID字符串：驱动不会做隐式类型转换，会直接按字符串类型存储
• UUID()、CSUUID()属于驱动兼容旧Mongo Shell的扩展语法，默认映射的是BinData subtype 3（遗留UUID格式），并非RFC 4122标准的subtype 4格式。

方式1：使用标准扩展JSON语法（无需修改全局配置） #

直接采用MongoDB官方扩展JSON规范构造subtype 4类型的UUID，不需要调整任何驱动配置，原有反序列化、插入逻辑可以直接复用，有两种可选写法：

• 易读写法（推荐）：使用$uuid关键字直接传入UUID字符串，驱动解析时会自动转换为subtype 4的BinData类型，不需要手动做Base64转换
  替换后的测试JSON如下：

  var testJson = "[{'_id': {'$uuid':'609e26f6-dbad-4dba-ba37-4e35f0e348ec'},'name':'Data1'},{'_id': {'$uuid':'609e26f6-dbad-4dba-ba37-4e35f0e348ff'},'name':'Data2'}]";
  

• 显式BinData写法：直接声明BinData子类型为4，值传入UUID对应RFC 4122标准大端序字节的Base64编码，示例格式：

  var testJson = "[{'_id': BinData(4, '<标准序字节转成的Base64值>'),'name':'Data1'},{'_id': BinData(4, '<标准序字节转成的Base64值>'),'name':'Data2'}]";
  

  注意：该写法的Base64值不能直接用C# Guid.ToByteArray()的结果转换，C#默认导出的Guid字节数组会对前三个字段做小端序调换，必须先转换为RFC 4122规定的标准大端序字节后再转Base64，否则会出现UUID值错乱的问题。

方式2：修改全局序列化配置，兼容原有CSUUID()写法 #

如果不想调整现有JSON的写法，可以在程序启动初始化阶段，配置C#驱动的全局Guid序列化规则为标准格式，配置代码如下：

BsonDefaults.GuidRepresentationMode = GuidRepresentationMode.V3;
BsonSerializer.RegisterSerializer(typeof(Guid), new GuidSerializer(GuidRepresentation.Standard));

配置完成后，原有使用CSUUID()包裹UUID的JSON解析后，会默认序列化为BinData subtype 4格式。

注意：该配置为全局生效，会影响项目内所有Guid字段的序列化、反序列化逻辑，如果项目中已经存量存储了subtype 3格式的UUID数据，需要额外做好兼容逻辑，避免存量数据查询异常。

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