Azure Functions隔离模式下使用CosmosDBOutput能否自动生成资源ID？

在.NET 8隔离模式的Azure Function里，使用CosmosDBOutput属性时没办法让系统自动生成新资源的ID，必须显式指定ID字段的值，不然就会触发你遇到的“One of the specified inputs is invalid”错误。

背后的原因 #

• .NET 6内联模式下，旧版Cosmos DB绑定依赖的SDK底层会自动给未指定ID的文档生成GUID当ID；
• 切换到隔离模式后，绑定的实现逻辑做了变更，不再提供自动生成ID的能力，要求开发者必须手动设置小写的id字段（Cosmos DB的ID字段大小写敏感，必须是小写的id）。

解决办法 #

有两种常见的处理方式：

1. 在实体类中默认生成
   在你的文档实体类里添加id属性，直接默认赋值GUID：

   public class YourDocumentEntity
   {
       public string id { get; set; } = Guid.NewGuid().ToString();
       // 其他业务属性
       public string Title { get; set; }
       public DateTime CreateTime { get; set; }
   }
   

2. 在函数逻辑中手动赋值
   如果不想在实体类里固定生成逻辑，可以在函数处理时给待写入的文档实例赋值ID：

   [Function("YourFunctionName")]
   [CosmosDBOutput(
       databaseName: "YourDB",
       containerName: "YourContainer",
       Connection = "CosmosDBConnectionString")]
   public YourDocumentEntity Run([HttpTrigger(AuthorizationLevel.Function, "post")] HttpRequestData req)
   {
       // 处理请求、构造文档
       var newDocument = new YourDocumentEntity
       {
           Title = "Test Document",
           CreateTime = DateTime.UtcNow
       };
       // 手动生成ID
       newDocument.id = Guid.NewGuid().ToString();
       return newDocument;
   }
   

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