Azure Cosmos DB v4 Java SDK CosmosClient使用与配置疑问

问题1：客户端实例使用方式建议 #

直接使用单个Cosmos DB客户端实例注入到所有Repository/Dao中即可，不需要为每个容器单独创建实例：

• Cosmos DB v4 Java SDK的客户端本身是线程安全的，单例模式下客户端会统一管理全局的连接池、分区元数据缓存、请求路由策略，能最大化复用资源，降低网络开销，完全符合官方的性能优化要求。
• 单实例客户端支持同时操作同一个Cosmos账号下的所有数据库、容器，没有访问隔离的问题，完全满足常规业务的Dao分层需求。
• 只有当你需要对接多个独立的Cosmos账号、或者需要用不同的权限凭证访问不同资源的特殊场景下，才需要创建多个客户端实例。如果没有这类需求，为每个Dao单独创建客户端只会导致连接重复建立、内存/端口资源浪费，反而会升高请求延迟、提升连接超时的概率。

问题2：maxConnectionsPerEndpoint参数取值判定标准 #

该参数定义了客户端对每个Cosmos后端服务节点最多可以建立的TCP连接数，两种场景下的取值逻辑如下：

单客户端实例（推荐场景）

默认值为130，大多数场景下直接使用默认值即可，需要调整时参考以下判定维度：

• 并发请求量级：如果业务持续高并发（单实例每秒请求数超过1万），且监控观测到请求排队、连接队列等待、P99延迟明显高于预期，可以逐步上调该值，最高不建议超过1000，调整时需要同步确认服务器的文件句柄数、端口范围限制足够支撑总连接数。
• 后端分区规模：Cosmos的总连接数=「maxConnectionsPerEndpoint」* 后端服务节点数，分区数越多对应的后端节点越多，该值设置过高容易触发系统连接数上限，需要结合分区规模调整。
• 请求特征：如果业务以大文档读写为主，单个连接的带宽占用高，不需要设置过高的连接数；如果以小请求高并发为主，可以适当调高该值提升并发承载能力。

多客户端实例（非推荐场景，仅特殊隔离需求下使用）

这种场景下每个客户端会独立维护自己的连接池，所以需要按客户端实例的数量等比例调低该参数：

• 比如你创建了N个独立的客户端实例，那每个实例的maxConnectionsPerEndpoint建议设置为「单实例推荐值/N」，避免总连接数过高导致端口耗尽、连接超时的问题。
• 再次强调，无特殊需求不要使用多客户端实例的架构，资源利用率会远低于单实例模式。

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