通过TNS连接外部Oracle数据库遇UnknownHostException如何解决

java.net.UnknownHostException本质是代码运行的主机无法解析TNS中配置的Oracle主机地址，和JDBC连接逻辑本身没有直接关联，可按以下步骤排查配置：

1 优先排查网络连通性 #

• 取出TNS文件中配置的HOST值，在代码运行的机器上执行ping <HOST地址>，如果提示无法解析主机，先解决域名解析问题：
  • 临时验证方案：修改本机hosts文件手动添加映射规则：[Oracle内网IP] [TNS中配置的HOST域名/主机名]，Windows系统hosts路径为C:\Windows\System32\drivers\etc\hosts，Linux/macOS系统路径为/etc/hosts
  • 永久生效方案：联系运维将该Oracle主机的域名映射配置到公司内部DNS服务器
• 域名解析通之后，再验证端口连通性，执行telnet <HOST地址> <端口号>或者nc -zv <HOST地址> <端口号>，如果端口连接失败，说明你的机器没有该数据库的网络访问权限，联系运维给当前机器开通Oracle对应端口的白名单即可。

2 正确使用TNS文件的JDBC连接写法 #

网络连通后可以直接用TNS文件简化连接配置，不需要手动拼接长串，避免拼写错误：

1. 将获取到的tnsnames.ora文件放到本地固定路径，例如/data/config/tnsnames.ora
2. 启动Java程序时添加JVM参数指定TNS文件所在目录：-Doracle.net.tns_admin=/data/config
3. JDBC连接串直接填写TNS文件中配置的服务别名即可，例如你的TNS中配置的服务别名为ORACLE_INNER，连接代码可以写成：

try {
    conn = DriverManager.getConnection("jdbc:oracle:thin:@ORACLE_INNER", user, password);
    // 后续业务逻辑
}

后续TNS配置更新时不需要修改代码，直接替换tnsnames.ora文件即可。

3 特殊场景补充配置 #

如果内部Oracle需要走SSL或代理访问，需要额外加参数：

• SSL连接场景：添加信任库配置

Properties props = new Properties();
props.setProperty("user", user);
props.setProperty("password", password);
props.setProperty("javax.net.ssl.trustStore", "/path/to/truststore.jks");
props.setProperty("javax.net.ssl.trustStorePassword", "你的信任库密码");
conn = DriverManager.getConnection("jdbc:oracle:thin:@ORACLE_INNER", props);

• 代理访问场景：启动时添加JVM参数：-DsocksProxyHost=内网代理地址 -DsocksProxyPort=代理端口

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