Jenkins流水线执行脚本无法连接Oracle数据库，请求协助解决

第一步：优先排查主机名解析问题 #

根源错误是java.net.UnknownHostException，说明Jenkins运行的服务器无法识别Oracle数据库的主机名，先解决这个核心问题：

• 登录Jenkins所在服务器（如果是容器部署的Jenkins，进入容器内部）
• 执行命令测试主机名解析：ping *********（替换为实际的Oracle主机名）
  • 如果ping不通，直接修改服务器的/etc/hosts文件，添加Oracle主机名与IP的映射：echo "Oracle数据库IP *********" >> /etc/hosts
  • 如果ping能正常返回结果，再进行下一步排查

第二步：测试端口连通性 #

主机名解析正常后，确认Jenkins服务器能访问Oracle的监听端口（默认1521）：

• 用telnet测试：telnet ********* 1521
• 或用nc命令：nc -zv ********* 1521
  • 如果连接失败，说明端口被拦截：
    • 检查Jenkins服务器本地防火墙（如iptables、firewalld）是否放行1521端口的出站请求
    • 检查Oracle数据库所在服务器的防火墙/安全组，是否允许Jenkins服务器的IP访问1521端口
    • 排查中间网络（公司网关、云服务商安全组）是否有端口限制规则

第三步：核对代理与环境变量差异 #

Jenkins的运行环境可能和本地存在代理设置差异：

• 登录Jenkins后台，进入「系统管理」→「系统设置」，检查全局代理配置，确认代理是否允许访问Oracle的主机和端口
• 在流水线脚本中添加打印环境变量的步骤，对比本地与Jenkins的http_proxy、https_proxy、no_proxy变量，确保Oracle主机名在no_proxy列表内
• 如果是Java脚本，检查Jenkins运行时是否添加了代理相关JVM参数（如-Dhttp.proxyHost），这类参数可能导致数据库连接走代理，而代理无法访问目标数据库

第四步：验证Java环境一致性 #

本地与Jenkins的Java环境差异也可能导致问题：

• 确认Jenkins使用的JDK版本和本地一致，避免版本兼容性引发的网络异常
• 检查Jenkins的JDK是否配置了匹配Oracle版本的JDBC驱动，驱动版本不匹配也可能触发连接报错

第五步：用IP替代主机名做验证 #

如果以上步骤都无效，尝试将脚本中的Oracle主机名替换为实际IP地址，重新运行流水线：

• 若用IP能正常连接，说明还是主机名解析的问题，回到第一步彻底修复
• 若用IP也无法连接，重点排查网络链路的连通性和端口拦截规则

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