Linux系统下DataGrip连接Oracle数据库失败求助

核心错误排查："the network adapter could not establish the connection" #

• 验证网络连通性
  先测试服务器可达性：

  ping <学校数据库服务器IP>
  

  再测试端口开放情况（默认Oracle端口1521）：

  telnet <服务器IP> 1521
  # 无telnet时用nc替代
  nc -zv <服务器IP> 1521
  

  若不通，优先确认是否需连接学校VPN，或联系网管排查防火墙拦截，也可能是服务器地址/端口输入错误。

• 配置Oracle客户端解析文件
  Linux下Oracle客户端依赖tnsnames.ora解析服务，路径通常为$ORACLE_HOME/network/admin/tnsnames.ora（即时客户端可手动创建/etc/tnsnames.ora，或设置TNS_ADMIN环境变量指定路径），配置示例：

  SCHOOL_DB =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
      (CONNECT_DATA =
        (SERVER = DEDICATED)
        (SERVICE_NAME = school_orcl)
      )
    )
  

  配置完成后执行tnsping SCHOOL_DB验证解析是否成功，成功会返回OK (xx msec)类信息。

• 检查环境变量
  确保Oracle相关环境变量正确设置，示例：

  export ORACLE_HOME=/usr/lib/oracle/19/client64
  export LD_LIBRARY_PATH=$ORACLE_HOME/lib
  export PATH=$ORACLE_HOME/bin:$PATH
  

  用echo $ORACLE_HOME验证变量是否生效。

URL配置规范 #

JDBC连接Oracle的URL有两种标准格式，根据学校数据库配置选择：

• 基于SID的格式：

  jdbc:oracle:thin:@<服务器IP>:1521:<数据库SID>
  

• 基于服务名的格式（现代Oracle版本优先推荐）：

  jdbc:oracle:thin:@//<服务器IP>:1521/<数据库服务名>
  

  其中<数据库SID>或<数据库服务名>需向学校数据库管理员确认，不可自行猜测。

"Target data source/schema"面板异常处理 #

该面板异常本质是连接未成功建立，先解决上述连接问题，待连接正常后面板会自动加载数据源和Schema信息。若仍异常，检查连接工具使用的Oracle驱动版本是否与服务器版本兼容：

• Oracle 11g → ojdbc6
• Oracle 12c/18c/19c → ojdbc8
• Oracle 21c → ojdbc11

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