VS Code中Oracle SQL Developer扩展创建连接遇ORA-12541错误的解决步骤

1. 检查Oracle监听器状态并启动 #

• 打开命令提示符（Windows）或终端（Linux/macOS），执行：
  lsnrctl status
• 若返回TNS-12541: 无监听器，说明监听器未启动，执行启动命令：
  lsnrctl start

2. 核对监听器配置文件 #

• 找到listener.ora文件，常规路径：
  Windows: ORACLE_HOME\network\admin\listener.ora
  Linux/macOS: $ORACLE_HOME/network/admin/listener.ora
• 确认配置中主机为localhost或本机IP，端口为1521，示例配置：

  LISTENER =
    (DESCRIPTION_LIST =
      (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
      )
    )
  

• 配置修改后，重启监听器：lsnrctl stop 再 lsnrctl start

3. 检查1521端口占用情况 #

• Windows执行：netstat -ano | findstr :1521
• Linux/macOS执行：lsof -i :1521 或 netstat -tulpn | grep :1521
• 若端口被其他程序占用，关闭占用程序，或修改Oracle监听器端口（需同步更新tnsnames.ora配置）

4. 确认Oracle相关服务运行状态 #

• Windows：打开services.msc，找到名称类似OracleOraDB19Home1TNSListener的服务（名称随Oracle版本变化），确保其处于“正在运行”状态，未运行则手动启动。
• Linux：执行systemctl status oracle-listener，未运行则启动：systemctl start oracle-listener

5. 测试基础连接 #

• 监听器正常后，用SQL*Plus测试：
  sqlplus 用户名/密码@localhost:1521/服务名
• 连接成功后，再验证VS Code扩展的连接参数（主机、端口、服务名）是否与配置一致

内容的提问来源于stack exchange，提问作者Ayush Kumar Gupta