JDBC读取ResultSet按列名取值时SQL别名不生效问题解决方案问询

根因分析 #

你遇到的别名不生效问题是JDBC API使用错误导致的：ResultSetMetaData.getColumnName() 方法的定义就是返回数据库表的原始列名，你要获取SQL中用AS定义的别名，需要调用ResultSetMetaData.getColumnLabel() 方法，这是JDBC规范中专门用于获取查询列别名的标准API。

两种方案的优劣对比 #

• 方案1：用列索引取值
  可以临时解决当前别名冲突问题，但是通用性极差：通用仓储类需要适配不同的查询SQL，只要后续调整SQL的字段顺序，或者新增、删除字段，取值逻辑就会出现不匹配的隐式故障，排查成本极高，不推荐在通用仓储场景使用。
• 方案2：按类型调用对应get方法
  这个方案完全没有解决你的核心问题：你拿不到正确的列别名，就算分类型调用getString/getInt，传入的还是重复的id/name原始列名，还是会取到错误的列值。而且JDBC的getObject()本身就支持根据列标签返回对应类型的对象，不需要手动适配类型，属于多此一举的优化。

最优解决方案 #

直接修改你获取列名的代码，把getColumnName替换为getColumnLabel即可，完全符合JDBC规范，兼容所有主流数据库驱动，不需要改动其他逻辑，也不会破坏现有其他查询的执行逻辑。
修正后的核心代码片段：

val columns: ListBuffer[String] = ListBuffer.empty
for (i <- 1 to columnCount) {
  // 替换为getColumnLabel获取SQL定义的别名
  columns += metadata.getColumnLabel(i)
}

注意：如果你使用的是5.x版本的MySQL JDBC驱动，需要在数据库连接字符串中添加参数useOldAliasMetadataBehavior=true，才能保证getColumnLabel正常返回别名。

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