Windows 11下VSCode的SQL Developer扩展报ORA-17190错误求助

核心原因 #

该错误源于Windows用户名包含括号等特殊字符，导致v$session.osuser属性值解析异常，和你在SQL Developer中遇到的问题本质一致，仅VSCode扩展的配置路径不同。

解决步骤 #

方法1：通过VSCode扩展配置添加VM参数 #

1. 按下Ctrl+,打开VSCode设置界面
2. 在搜索框输入Oracle SQL Developer: Jvm Options
3. 在对应输入框中添加以下参数二选一：
   • 针对编码解析问题：

     -Doracle.jdbc.osuser.encoding=Cp1252
     

   • 针对特殊字符用户名问题，替换为你的纯文本用户名（不含域、括号等特殊字符）：

     -Duser.name=你的纯文本用户名
     

方法2：直接修改扩展配置文件 #

1. 找到VSCode扩展安装目录，常规路径为：

   C:\Users\<你的Windows用户名>\.vscode\extensions\oracle.oracledevtools-<版本号>
   

2. 在该目录下找到sqldeveloper.conf文件（对应SQL Developer的ide.conf）
3. 打开文件添加一行（可复用你之前在SQL Developer中生效的VM参数）：

   AddVMOption -Doracle.jdbc.osuser.encoding=Cp1252
   

方法3：临时通过环境变量规避 #

1. 打开命令提示符（CMD），输入：

   set USERNAME=纯文本用户名
   

2. 在当前CMD窗口启动VSCode：

   code
   

3. 在该VSCode实例中尝试连接Oracle，此时扩展会使用你设置的纯文本用户名，避免特殊字符解析错误。

验证 #

完成配置后重启VSCode，重新用Oracle认证登录连接数据库，此时v$session.osuser值可正常解析，不会触发ORA-17190错误。

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