如何解决Oracle SQL Developer供应商代码17002报错问题

报错IO: The Network Adapter could not establish the connection Vendor code 17002的本质是SQL Developer客户端无法通过网络访问到目标Oracle数据库的监听服务，SQL Developer属于纯客户端管理工具，本身不内置Oracle数据库服务端程序。

排查与解决步骤 #

• 优先确认是否已部署Oracle数据库实例
  仅安装SQL Developer无法直接使用，你需要先单独部署Oracle数据库服务端（本地安装Express版/个人版，或使用远程已部署的实例均可），完成数据库初始化、启动监听服务后再进行连接操作。
• 核对连接参数（无需依赖tnsnames.ora）
  SQL Developer默认支持基础直连模式，不需要本地配置tnsnames.ora文件，新建连接时填写以下参数即可：
  • 主机名：本地实例填localhost/127.0.0.1，远程实例填数据库所在服务器的IP/域名
  • 端口：Oracle监听默认端口为1521，如有自定义修改填对应端口
  • 服务名/SID：Express版默认SID为XE，企业版默认服务名为ORCL，按实际实例配置填写
  • 用户名/密码：填写数据库已创建的用户凭证，系统管理员默认用户为sys/system，密码为数据库安装时设置的密码
• 确认监听服务与网络连通性
  • 本地Windows环境：打开系统服务列表，找到OracleOraDBxx_home1TNSListener（xx为你的数据库版本号），确认服务状态为正在运行，未启动则手动启动即可
  • 本地Linux环境：切换到Oracle用户执行lsnrctl status查看监听状态，异常时执行lsnrctl start启动监听
  • 远程实例环境：在本地执行telnet 数据库IP 1521测试端口连通性，连接失败需要排查服务器防火墙、安全组是否开放对应端口，以及监听是否绑定了可访问的IP地址
• 关于找不到tnsnames.ora、listener.ora的说明
  仅安装SQL Developer客户端的场景下，本地不会生成这两个配置文件，二者属于Oracle服务端的配置文件，只有部署了Oracle数据库服务端后，才会在服务端安装目录的network/admin路径下生成。

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