Oracle SQL Developer连接失败：网络适配器无法建立连接（错误17002）

• 确认Oracle数据库服务状态
  Windows系统按Win+R输入services.msc，Linux用systemctl status oracle-xe（或对应服务名），检查OracleServiceORCL、OracleOraDB19Home1TNSListener这类核心服务是否运行，未运行则手动启动。

• 验证监听配置与状态
  找到$ORACLE_HOME/network/admin下的listener.ora文件，确认监听地址设置正确（如0.0.0.0允许远程连接，或匹配本机IP）。执行以下命令重启监听并检查状态：

  lsnrctl stop
  lsnrctl start
  lsnrctl status
  

  确认输出中存在目标数据库实例的注册信息。

• 核对连接参数准确性
  在SQL Developer连接配置页：

  • 主机名填数据库所在机器的IP/主机名，本地连接可使用localhost或127.0.0.1
  • 端口默认1521，需与监听配置的端口完全一致
  • SID/服务名要匹配数据库实例名，可在数据库端执行select name from v$database;查询确认

• 测试网络端口连通性
  用以下命令测试1521端口是否可达：

  telnet 目标主机IP 1521
  # 或用nc命令
  nc -zv 目标主机IP 1521
  

  若不通，检查防火墙是否开放1521端口，或网络路由是否存在问题。

• 检查JDBC驱动兼容性
  确保SQL Developer使用的JDBC驱动版本与Oracle数据库版本匹配，版本差异过大可能导致连接失败。可在SQL Developer中更新驱动，或下载对应版本的ojdbc.jar添加到驱动库。

• 尝试OS认证连接（本地数据库）
  连接类型选择OS Authentication，无需输入账号密码直接连接，以此排查是否为数据库本身的权限或实例问题。

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