Azure Function报Cannot bind parameter绑定错误如何解决？

• 参数没有绑定特性：Run方法中的DocumentClient client参数未添加[CosmosDB]绑定特性，函数运行时无法识别该参数对应的Cosmos DB连接配置，触发绑定失败。
• 扩展版本不兼容：如果你使用的是V4版本的Cosmos DB函数扩展，旧的DocumentClient类型已被废弃，默认不再支持该类型的绑定。
• 扩展未注册：如果使用孤立进程模型的Azure Function，未在启动代码中注册Cosmos DB扩展，也会触发绑定校验失败。

方案1：添加绑定特性（适配V2/V3版Cosmos DB扩展） #

直接给DocumentClient参数添加绑定特性，指定对应的连接字符串配置项即可：

[FunctionName( "MigrateWithChangeFeed" )]
public static async Task Run( [CosmosDBTrigger(
    databaseName: "sourcedb",
    collectionName: "sourcecollection",
    StartFromBeginning = true,
    ConnectionStringSetting = "CosmosDBConnection",
    LeaseCollectionName = "leases",            
    CreateLeaseCollectionIfNotExists = true
)] IReadOnlyList<Document> source, 
// 新增CosmosDB绑定特性
[CosmosDB(ConnectionStringSetting = "CosmosDBConnection")] DocumentClient client,
ILogger log )

同时确认本地local.settings.json的Values节点中已经配置了CosmosDBConnection对应的连接字符串。

方案2：适配V4版Cosmos DB扩展 #

如果已经升级到V4版Cosmos DB扩展，替换废弃的类型和API即可：

1. 替换触发器和绑定参数的类型与配置：

[FunctionName( "MigrateWithChangeFeed" )]
public static async Task Run( [CosmosDBTrigger(
    databaseName: "sourcedb",
    // V4扩展中collectionName改名为containerName
    containerName: "sourcecollection",
    StartFromBeginning = true,
    // V4扩展中ConnectionStringSetting改名为Connection
    Connection = "CosmosDBConnection",
    LeaseContainerName = "leases",            
    CreateLeaseContainerIfNotExists = true
)] IReadOnlyList<JObject> source, 
[CosmosDB(Connection = "CosmosDBConnection")] CosmosClient client,
ILogger log )

2. 把函数代码中所有DocumentClient相关的操作替换为CosmosClient对应的API。

方案3：补充扩展注册（仅孤立进程模型需要） #

如果使用的是孤立进程模型的Azure Function，在Program.cs启动代码中添加Cosmos DB扩展注册：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    // 注册Cosmos DB扩展
    .AddCosmosDB()
    .Build();

host.Run();

额外提示：你当前的代码逻辑存在重复同步问题，Cosmos DB触发器会在有数据变更时触发，而函数内部又全量查询源容器做写入，会导致重复写入目标容器，建议按需调整逻辑。

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