为何Azure Functions中@CosmosDB注解参数与官方文档不一致？

1. 为何你的代码需要用connection而非connectionStringSetting #

这是Azure Functions Java Cosmos DB绑定的版本迭代导致的参数名统一变更：

• 旧版（Cosmos DB绑定v3及更早）：使用connectionStringSetting参数指定配置中存储连接字符串的键名；
• 新版（Cosmos DB绑定v4及以上）：官方将参数名统一简化为connection，功能完全等价，只是命名更简洁规范。

你的项目中触发函数要求用connection，说明当前使用的是v4及以上版本的绑定库。

2. connection参数是否安全可用 #

完全安全可用。它的作用和旧版connectionStringSetting一致：从应用配置（本地开发的local.settings.json、部署后的Azure门户应用设置）中读取Cosmos DB连接字符串，避免硬编码敏感信息，完全符合Azure安全最佳实践。

3. 是否使用了废弃版本 #

你当前使用的是主流支持的新版本，并非废弃版本：

• 要求用connection的v4+绑定是官方当前维护的版本，拥有更完善的功能和兼容性；
• 旧版的connectionStringSetting属于v3及更早的绑定参数，已经被官方标记为弃用，不再推荐使用。

4. pom.xml中的版本对应关系 #

关键看azure-functions-java-library和azure-functions-maven-plugin的版本：

• 废弃的版本组合：azure-functions-java-library版本为1.x.x系列（对应绑定v3），此时使用connectionStringSetting；
• 当前推荐的版本组合：azure-functions-java-library版本为2.x.x及以上（对应绑定v4），azure-functions-maven-plugin版本为1.13.0及以上（适配v4运行时），此时必须使用connection参数。

示例pom.xml依赖片段：

<!-- v4绑定对应的核心库 -->
<dependency>
    <groupId>com.microsoft.azure.functions</groupId>
    <artifactId>azure-functions-java-library</artifactId>
    <version>2.0.1</version>
</dependency>

<!-- 适配v4运行时的Maven插件 -->
<plugin>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>azure-functions-maven-plugin</artifactId>
    <version>1.22.0</version>
</plugin>

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