如何使用 ResultSet.getMetaData() 在 Java 中动态获取查询结果的列名和数据类型？

本文共计863个文字，预计阅读时间需要4分钟。

可以通过调用`ResultSet.getMetaData()`方法获取`ResultSetMetaData`对象，然后使用该方法逐列读取列名、SQL类型和Java类型等信息。具体步骤如下：

获取列名和 SQL 类型

ResultSetMetaData 提供了按列序号访问列定义的能力：

• getColumnCount()：返回结果集中列的总数
• getColumnName(int column)：返回第 column 列的原始列名（如 SQL 中写的 SELECT name AS username，这里返回 "username"）
• getColumnLabel(int column)：更推荐使用，它返回显示用的标签名（通常与 getColumnName 一致，但对别名更可靠）
• getColumnTypeName(int column)：返回数据库底层类型名（如 "VARCHAR"、"BIGINT"、"TIMESTAMP"）
• getColumnType(int column)：返回 java.sql.Types 中定义的整型常量（如 Types.VARCHAR、Types.INTEGER）

映射 SQL 类型到 Java 类型

getColumnType() 返回的是 JDBC 标准类型码，需手动转换为对应 Java 类。常用映射示例如下：

• Types.VARCHAR, Types.CHAR, Types.LONGVARCHAR → String.class
• Types.INTEGER, Types.SMALLINT, Types.TINYINT → Integer.class
• Types.BIGINT → Long.class
• Types.DECIMAL, Types.NUMERIC → BigDecimal.class
• Types.DATE → java.sql.Date.class（或转为 LocalDate）
• Types.TIMESTAMP → java.sql.Timestamp.class（或转为 LocalDateTime）
• Types.BOOLEAN → Boolean.class
• Types.BINARY, Types.VARBINARY → byte[].class

实际中建议封装一个工具方法，根据 getColumnType() 返回值查表返回对应 Class 对象。

立即学习“Java免费学习笔记（深入）”；

完整示例代码

以下是一个安全遍历元数据并打印列信息的片段：

ResultSet rs = stmt.executeQuery("SELECT id, name, created_at FROM user"); ResultSetMetaData meta = rs.getMetaData(); int columnCount = meta.getColumnCount(); for (int i = 1; i <= columnCount; i++) { String label = meta.getColumnLabel(i); String typeName = meta.getColumnTypeName(i); int sqlType = meta.getColumnType(i); String typeClassName = meta.getColumnClassName(i); // 可选：驱动返回的默认 Java 类全限定名 System.out.printf("列 %d: 标签='%s', 类型='%s'(%d), Java类='%s'%n", i, label, typeName, sqlType, typeClassName); }

注意：getColumnClassName() 并非所有驱动都准确实现（如 MySQL Connector/J 会返回 java.lang.String 即使是数值列），因此更稳妥的方式仍是依据 getColumnType() + 映射表判断。

注意事项与避坑点

• 列索引必须从 1 开始，传入 0 或超出范围会抛 SQLException
• 某些数据库（如 PostgreSQL）对大小写敏感，getColumnLabel() 返回的名称可能含双引号，解析别名时建议忽略引号或统一转小写
• 动态查询（如 SELECT *）下，列顺序和数量不确定，务必依赖元数据而非硬编码索引
• 如果 ResultSet 已关闭，调用 getMetaData() 会抛异常，确保在 rs.next() 循环前或过程中调用
• 部分老版本驱动对 TIME、ARRAY、JSON 等类型支持不完善，需结合数据库文档测试验证