jdbcTemplate.query和queryForObject方法的使用及区别
作者：码农辰南
这篇文章主要分析了Spring框架中JdbcTemplate的query()和queryForObject()方法的区别,并提出了一些建议来避免在查询时出现权限不足的问题
一、问题原因
上周再项目上遇到一个信息集权限不足时，输出word功能中报错，查看代码发现该块查询逻辑直接使用了jdbcTemplate.queryForObject，根本没考虑信息集权限不足的情况，会出现查询不到数据导致报错的问题，下面就针对query() 和 queryForObject()做一下分析。
二、query() 和 queryForObject() 区别
JdbcTemplate 的 query() 和 queryForObject() 是 Spring 中操作数据库最常用的两个查询方法，核心区别在于返回结果形态、空结果处理、适用场景，以下是详细对比：
| 特性 | jdbcTemplate.query() | jdbcTemplate.queryForObject() |
|---|---|---|
| 返回值类型 | List（多条结果，无结果则返回空 List） | T（单条结果，必须返回且仅返回 1 条） |
| 空结果处理 | 无匹配数据时返回空 List（[]），不抛异常 | 无匹配数据时抛 EmptyResultDataAccessException |
| 多结果处理 | 支持 0 条、1 条、多条结果 | 仅支持恰好 1 条结果，多条则抛 IncorrectResultSizeDataAccessException |
| 核心参数 | 需指定 RowMapper/ResultSetExtractor 映射结果 | 需指定 RowMapper/ 返回类型（如 Integer.class） |
| 适用场景 | 批量查询（列表查询）、允许无结果的单条查询 | 明确仅需 1 条结果的场景（如根据唯一 ID 查单条数据） |
三、修改建议
1、使用JdbcTemplate.query()替换 JdbcTemplate.queryForObject()
BeanPropertyRowMapper<Person> rowMapper = new BeanPropertyRowMapper<>(Person.class);
String sql = "select * from person where personId = '12'";
//下面这段代码有问题，当personId中12不存在，则会报异常EmptyResultDataAccessException
//Person person = jdbcTemplate.queryForObject(sql, rowMapper);
//使用query替换queryForObject
List<Person> query = jdbcTemplate.query(sql, rowMapper);
if(query != null){
Person person = query.get(0);
}
2、使用mybatis替换 JdbcTemplate.queryForObject()
//BeanPropertyRowMapper<Person> rowMapper = new BeanPropertyRowMapper<>(Person.class); String sql = "select * from person where personId = '12'"; //下面这段代码有问题，当personId中12不存在，则会报异常EmptyResultDataAccessException //Person person = jdbcTemplate.queryForObject(sql, rowMapper); //使用mybatis替换queryForObject，mybatis查询不到数据会返回null Person person = rmbReportMapper.queryPersonBySql(sql);
四、总结
- query() 是 “通用查询”，灵活处理任意条数结果，无异常风险；
- queryForObject() 是 “单结果查询”，强约束结果数量，适合明确仅需 1 条的场景；
- 日常开发中，除非确认数据必存在，否则优先用 query()处理单条查询，避免空结果异常。
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。