Visual Studio Code中SQLTools扩展无法连接Oracle数据库求助

错误原因 #

错误NJS-516: no configuration directory set or available to search for tnsnames.ora表明SQLTools依赖的Oracle Node.js驱动（oracledb）无法找到Oracle配置文件目录，或者你使用的tnsnames.ora别名未正确配置。结合你通过代理安装扩展的情况，还可能存在驱动依赖未完整安装的问题。

解决方案 #

1. 直接使用EZConnect连接字符串（绕过tnsnames.ora） #

修改连接配置中的connectString为EZConnect格式，无需依赖tnsnames.ora文件：

{
  "oracleOptions": {
    "autoCommit": false,
    "lowerCase": false,
    "thickMode": false
  },
  "previewLimit": 50,
  "askForPassword": true,
  "server": "localhost",
  "port": 1521,
  "driver": "Oracle",
  "connectString": "//localhost:1521/testdb.bank.it",
  "username": "my-username",
  "name": "TEST_testdb"
}

2. 配置TNS_ADMIN环境变量（若必须使用tnsnames.ora） #

• Windows系统：打开「系统属性→高级→环境变量」，添加TNS_ADMIN变量，值设为包含tnsnames.ora的文件夹路径（例如C:\oracle\network\admin），之后重启VS Code生效。
• Linux/macOS系统：在终端执行export TNS_ADMIN=/path/to/oracle/admin，或在VS Code的settings.json中添加终端环境变量配置：

  "terminal.integrated.env.linux": {
    "TNS_ADMIN": "/path/to/oracle/admin"
  }
  

  同时确保tnsnames.ora中存在对应数据库条目：

  testdb.bank.it =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
      (CONNECT_DATA =
        (SERVER = DEDICATED)
        (SERVICE_NAME = testdb.bank.it)
      )
    )
  

3. 重新安装Oracle驱动（修复代理安装导致的依赖缺失） #

代理环境下安装扩展可能导致oracledb驱动未完整部署，手动重新安装：

1. 定位SQLTools扩展目录：
   • Windows：%USERPROFILE%\.vscode\extensions\mtxr.sqltools-*
   • Linux/macOS：~/.vscode/extensions/mtxr.sqltools-*
2. 进入该目录下的node_modules/sqltools-driver-oracle文件夹
3. 执行以下命令（确保npm已配置代理）：

   npm config set proxy http://your-proxy:port
   npm config set https-proxy http://your-proxy:port
   npm install oracledb --save
   

4. 验证VS Code代理配置 #

确保VS Code能通过代理访问外部资源，在settings.json中添加：

"http.proxy": "http://your-proxy:port",
"https.proxy": "http://your-proxy:port",
"http.proxyStrictSSL": false

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