Spring Boot与MongoDB在OpenShift上集成失败问题排查

嘿，我来帮你捋一捋这个集成问题！本地跑好好的，一到OpenShift就超时，大概率是连接配置、网络访问或者权限这几个环节出了问题，咱们一步步来排查：

1. 先确认连接参数是否用对了OpenShift的内部环境变量 #

OpenShift上部署MongoDB后，会自动生成一系列环境变量，你的Spring Boot应用应该读取这些变量来配置连接，而不是本地的localhost！

默认情况下，MongoDB服务暴露的环境变量包括：

• MONGODB_SERVICE_HOST：MongoDB服务的内部主机名
• MONGODB_SERVICE_PORT：MongoDB的端口（一般是27017）
• MONGODB_DATABASE：自动创建的数据库名
• MONGODB_USER：数据库用户名
• MONGODB_PASSWORD：数据库密码

你需要把Spring Boot的配置文件（比如application.yml）改成读取这些变量，示例如下：

spring:
  data:
    mongodb:
      host: ${MONGODB_SERVICE_HOST}
      port: ${MONGODB_SERVICE_PORT}
      database: ${MONGODB_DATABASE}
      username: ${MONGODB_USER}
      password: ${MONGODB_PASSWORD}

如果之前硬编码了本地的localhost或者固定数据库名，肯定会连不上OpenShift上的MongoDB。

2. 检查Spring Boot Pod到MongoDB服务的网络连通性 #

超时很多时候是网络不通导致的，咱们可以直接在Spring Boot的Pod里测试连接：

• 先获取Spring Boot的Pod名称：oc get pods
• 进入Pod的shell：oc rsh <你的Spring Boot Pod名称>
• 测试能不能ping通MongoDB服务：ping mongodb（默认MongoDB服务名就是mongodb，如果你改了名称就用对应的）
• 或者测试端口连通性：telnet mongodb 27017

如果ping不通或者telnet失败，可能是：

• MongoDB的Pod没正常运行：用oc get pods看MongoDB的状态是不是Running
• 网络策略限制：检查项目里有没有配置网络策略，阻止了Spring Boot访问MongoDB
• 服务没正确暴露：用oc get services确认MongoDB服务的端口是27017，并且类型是ClusterIP（内部访问用这个就行）

3. 确认MongoDB的数据库和权限配置 #

你说改了数据库名没解决，那得确认几点：

• 新的数据库是否已经被创建：进入MongoDB的Pod，用mongo命令连接，然后输入show dbs，看看目标数据库是否存在
• 用户有没有该数据库的权限：在MongoDB的shell里，切换到目标数据库use <你的数据库名>，然后输入db.getUser("${MONGODB_USER}")，检查用户的roles里有没有该数据库的readWrite权限

默认的OpenShift MongoDB模板会创建指定数据库和对应权限的用户，但如果手动修改数据库名后，可能需要重新配置用户权限，或者删除重建MongoDB应用时指定正确的数据库名。

4. 深挖日志里的异常细节 #

日志里的异常信息是关键！你得重点看：

• 如果是UnknownHostException：说明Spring Boot用的主机名不对，要么是环境变量没正确注入，要么是服务名拼写错误
• 如果是ConnectionTimeoutException：就是网络不通，回到第二步排查
• 如果是AuthenticationFailedException：大概率是用户名密码不对，或者数据库名和用户授权的数据库不匹配
• 如果是MongoSocketReadTimeoutException：可能是MongoDB服务响应慢，或者资源不足（免费主机的资源有限，看看MongoDB的Pod有没有资源告警）

5. 检查MongoDB驱动与服务器版本兼容性 #

有时候驱动版本和MongoDB服务器版本不兼容也会导致连接问题。比如MongoDB 5.0+需要MongoDB Java驱动4.0以上，而Spring Boot的starter版本会对应不同的驱动版本。你可以检查pom.xml里的spring-boot-starter-data-mongodb版本，确保和OpenShift上的MongoDB版本匹配。

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