如何将基于Gradle和Spring Data MongoDB Starter的Java应用连接到禁用公网访问的Azure Cosmos DB（Mongo API）服务

嘿，我来帮你搞定这个连接问题！你之前靠环境变量就能轻松对接公网Cosmos DB，但面对禁用公网访问的实例时，得依赖私有端点来建立专属连接，咱们一步步梳理关键操作：

一、先确保应用网络能触达私有端点 #

这是基础前提，你的Java应用得能访问到私有端点关联的虚拟网络：

• 优先把应用部署在nonprod-vnet的private-endpoints子网（或同VNet下的其他子网）；
• 如果应用不在这个VNet内，得通过VNet对等连接、VPN网关或者ExpressRoute等方式打通网络，让应用能访问到该VNet的资源。

二、配置DNS解析（核心关键） #

私有端点有自己的私有IP，你得让应用能把Cosmos DB域名正确解析到这个私有IP，不然还是会尝试连公网：

• 推荐方案：Azure私有DNS区域
  为Mongo API类型的Cosmos DB创建privatelink.mongo.cosmos.azure.com私有DNS区域，然后将你的私有端点cosmos-private-private-endpoint关联到这个区域。这样VNet内的应用会自动从私有DNS获取正确的私有IP解析结果。
• 备选方案：手动配置hosts文件
  如果没法用Azure私有DNS，可在应用所在服务器的hosts文件中添加映射：

  [私有端点实际IP]  cosmos-private.mongo.cosmos.azure.com
  

  替换[私有端点实际IP]为你私有端点的真实IP，cosmos-private.mongo.cosmos.azure.com为你的私有Cosmos DB实例域名。

三、调整应用连接配置 #

配置逻辑和公网场景类似，只需更新对应环境变量即可，Spring Boot的Mongo Starter会自动处理后续连接：

• 更新环境变量示例：

  MONGO_DB_HOST= cosmos-private.mongo.cosmos.azure.com
  MONGO_DB_DATABASE_NAME= [你的私有库名称]
  MONGO_DB_USERNAME= [私有实例用户名]
  MONGO_DB_PASSWORD= [私有实例密码]
  MONGO_DB_PORT= 10255
  MONGO_DB_URI= mongodb://cosmos-private:[密码]@cosmos-private.mongo.cosmos.azure.com:10255/?ssl=true
  

  注意：MONGO_DB_URI必须开启ssl=true，Cosmos DB强制要求加密连接。

四、提前验证连接有效性 #

正式部署应用前，建议先在VNet内的测试机器上验证连接：

• 使用Mongo Shell执行连接命令：

  mongosh "mongodb://cosmos-private:[密码]@cosmos-private.mongo.cosmos.azure.com:10255/?ssl=true"
  

  如果能成功连接并执行数据库操作（比如show dbs），说明网络和DNS配置没问题，应用侧的配置就不会出问题。

常见坑点排查 #

• 检查私有端点所在子网的NSG（网络安全组）是否允许10255端口的入站流量；
• 用nslookup cosmos-private.mongo.cosmos.azure.com在应用服务器上测试解析结果，确认返回的是私有端点IP而非公网IP；
• 确保Spring Boot和Spring Data MongoDB的版本较新（推荐Spring Boot 2.4+），避免兼容性问题。

备注：内容来源于stack exchange，提问作者ban_ana