Oracle SQL Developer连接MariaDB时列别名失效问题排查

问题现象 #

使用Oracle SQL Developer（23.1.1.345.2114）通过MySQL JDBC驱动（9.0.0）连接MariaDB（11.4.2）时，出现以下异常：

• 执行直接引用列并设置别名的SELECT语句，返回结果显示原列名而非别名，例如：

  select name, phone_number, num0 as age, state_location as state_abbreviation from employee;
  

  结果列名仍为num0、state_location，而非设置的age、state_abbreviation。
• 对列进行函数处理后设置别名，别名能正常显示，例如：

  SELECT name, phone_number, cast(num0 as int) as age, CAST(state_location AS VARCHAR(2)) AS state_abbr FROM employee;
  

• 直接通过MariaDB命令行执行相同别名语句，别名正常生效；尝试多种别名写法（num0 as age、num0 "age"等）均无效。

原因分析 #

1. MySQL JDBC驱动的元数据返回行为配置 #

MySQL JDBC驱动的useOldAliasMetadataBehavior参数控制ResultSetMetaData中列别名的返回逻辑：

• 当该参数设为true时，驱动对于直接引用的表列，会将getColumnLabel()和getColumnName()都返回原列名；仅对经过表达式/函数处理的列，getColumnLabel()返回别名。
• MySQL JDBC 9.0.0版本可能默认启用了该行为，而Oracle SQL Developer在展示结果时，优先读取getColumnName()的值，导致直接列的别名无法显示。

2. Oracle SQL Developer对JDBC元数据的读取策略 #

Oracle SQL Developer在渲染查询结果列名时，可能存在逻辑差异：

• 对于原生Oracle连接，工具会优先使用getColumnLabel()获取别名；但针对MySQL/MariaDB这类第三方数据库连接，可能 fallback 到getColumnName()，而该字段在驱动默认配置下返回原列名。
• 经过函数处理的列，驱动会确保getColumnLabel()返回别名，所以能正常显示。

3. MySQL JDBC与MariaDB的兼容性差异 #

MySQL JDBC驱动并非MariaDB官方驱动，两者在元数据协议的细节上存在适配问题：

• MariaDB 11.4.2的查询结果元数据返回格式，与MySQL 9.0.0驱动的预期不完全匹配，导致直接列的别名信息未被正确传递到SQL Developer。
• 命令行工具直接解析SQL执行后的结果集元数据，不受JDBC驱动的中间处理影响，因此别名正常。

验证与解决方向 #

1. 修改连接URL，添加参数：useOldAliasMetadataBehavior=false，强制驱动返回别名到getColumnLabel()。
2. 替换为MariaDB官方JDBC驱动（Connector/J），测试是否能解决兼容性问题。
3. 在SQL Developer中检查是否有针对第三方数据库的结果集显示配置，尝试切换列名读取策略。

内容的提问来源于stack exchange，提问作者Obi-Juan