.NET使用AWS DocumentDb时出现“Command find failed: Feature not supported”错误

核心原因 #

你遇到的问题是MongoDB C#驱动默认行为触发了Azure Cosmos DB（DocumentDb）MongoAPI兼容层不支持的特性。虽然DocumentDb 4.0兼容MongoDB 4.0协议，但并非完全等价，C#驱动的默认查询选项与mongosh的极简查询存在差异。

常见不支持的特性 #

• allowDiskUse默认启用：C#驱动在执行无过滤条件的查询时，可能默认添加allowDiskUse: true选项，而DocumentDb不支持该参数（它本身的存储模型不需要磁盘临时存储查询结果）。
• 驱动附加的游标选项：部分版本的驱动会默认设置一些游标相关参数（如batchSize的特殊值），这些参数在DocumentDb中不被支持。

解决步骤 #

1. 使用显式空过滤器替代Lambda表达式
   避免驱动对Lambda表达式_ => true做额外处理，直接使用官方提供的空过滤器：

   var emptyFilter = Builders<YourDocumentType>.Filter.Empty;
   var results = myCollection.Find(emptyFilter).ToList();
   

2. 显式禁用allowDiskUse选项
   强制关闭驱动默认启用的该选项，匹配DocumentDb的限制：

   var options = new FindOptions
   {
       AllowDiskUse = false
   };
   var results = myCollection.Find(_ => true, options).ToList();
   

3. 配置驱动与DocumentDb版本匹配
   在初始化MongoClient时指定ServerApi版本为4.0，确保驱动行为与DocumentDb兼容：

   var clientSettings = MongoClientSettings.FromConnectionString("你的连接字符串");
   clientSettings.ServerApi = new ServerApi(ServerApiVersion.V4);
   var client = new MongoClient(clientSettings);
   var myCollection = client.GetDatabase("你的库名").GetCollection<YourDocumentType>("MyDocs");
   

为什么mongosh可以正常运行？ #

mongosh执行db.MyDocs.find()时，只会发送最基础的find命令（无任何附加选项），完全符合DocumentDb兼容层的支持范围；而C#驱动为了适配原生MongoDB的场景，默认添加了一些DocumentDb不支持的参数，导致触发“Feature not supported”异常。

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