VS Code Oracle Developer Tools扩展Oracle数据库连接问题排查

问题背景 #

已通过Oracle SQL Developer正常连接本地Oracle数据库，但使用VS Code的Oracle Developer Tools扩展时，相同配置连接失败，报错：

Error opening connection 'USERNAME.SERVICENAME'. Details: ORA-01017: invalid username/password; logon denied

核心问题点：

1. 全小写用户名在VS Code连接窗口被自动转为大写，手动添加双引号无效
2. 不确定VS Code扩展的连接字符串构造逻辑是否与SQL Developer一致

解决方案与排查步骤 #

1. 修复小写用户名被自动转大写的问题 #

VS Code的Oracle扩展UI输入框会自动将用户名转为大写，需通过手动编辑配置文件强制识别小写用户名：

• 打开VS Code设置，搜索Oracle: Connections，点击编辑 in settings.json
• 在settings.json中找到目标连接的配置条目，将user字段的值改为带转义双引号的小写用户名，示例：

  "oracle.connections": [
    {
      "name": "你的连接名",
      "user": "\"username\"",
      "password": "你的密码",
      "connectString": "hostname:port/servicename"
    }
  ]
  

• 保存配置后，重新尝试连接

2. 验证连接字符串构造逻辑 #

VS Code扩展会自动拼接用户名与地址信息，无需手动添加username@//前缀，可通过日志确认实际连接字符串：

• 在VS Code设置中搜索Oracle: Log Level，设置为Debug
• 尝试连接后，打开输出面板，选择Oracle Developer Tools查看日志，检查日志中显示的连接字符串是否正确包含带双引号的小写用户名和完整的//hostname:port/servicename地址

3. 额外排查点 #

• 密码大小写敏感：如果数据库开启了密码大小写敏感（SEC_CASE_SENSITIVE_LOGON参数为TRUE），确保密码输入完全匹配，特殊字符需正确转义
• 数据库参数验证：在SQL Developer中执行以下语句，确认大小写敏感设置：

  SELECT value FROM v$parameter WHERE name = 'sec_case_sensitive_logon';
  

  若返回TRUE，必须严格匹配用户名和密码的大小写格式
• 直接使用EZConnect连接字符串：若上述方法无效，可在settings.json的connectString字段直接填写完整的EZConnect格式字符串：

  "connectString": "\"username\"@//hostname:port/servicename"
  

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