快捷導(dǎo)航

jdbcTemplate.query和queryForObject方法的使用及區(qū)別

更新時間：2025年12月30日 10:49:46 作者：碼農(nóng)辰南

這篇文章主要分析了Spring框架中JdbcTemplate的query()和queryForObject()方法的區(qū)別,并提出了一些建議來避免在查詢時出現(xiàn)權(quán)限不足的問題

一、問題原因

上周再項目上遇到一個信息集權(quán)限不足時，輸出word功能中報錯，查看代碼發(fā)現(xiàn)該塊查詢邏輯直接使用了jdbcTemplate.queryForObject，根本沒考慮信息集權(quán)限不足的情況，會出現(xiàn)查詢不到數(shù)據(jù)導(dǎo)致報錯的問題，下面就針對query() 和 queryForObject()做一下分析。

二、query() 和 queryForObject() 區(qū)別

JdbcTemplate 的 query() 和 queryForObject() 是 Spring 中操作數(shù)據(jù)庫最常用的兩個查詢方法，核心區(qū)別在于返回結(jié)果形態(tài)、空結(jié)果處理、適用場景，以下是詳細(xì)對比：

特性	jdbcTemplate.query()	jdbcTemplate.queryForObject()
返回值類型	List（多條結(jié)果，無結(jié)果則返回空 List）	T（單條結(jié)果，必須返回且僅返回 1 條）
空結(jié)果處理	無匹配數(shù)據(jù)時返回空 List（[]），不拋異常	無匹配數(shù)據(jù)時拋 EmptyResultDataAccessException
多結(jié)果處理	支持 0 條、1 條、多條結(jié)果	僅支持恰好 1 條結(jié)果，多條則拋 IncorrectResultSizeDataAccessException
核心參數(shù)	需指定 RowMapper/ResultSetExtractor 映射結(jié)果	需指定 RowMapper/ 返回類型（如 Integer.class）
適用場景	批量查詢（列表查詢）、允許無結(jié)果的單條查詢	明確僅需 1 條結(jié)果的場景（如根據(jù)唯一 ID 查單條數(shù)據(jù)）

三、修改建議

1、使用JdbcTemplate.query()替換 JdbcTemplate.queryForObject()

BeanPropertyRowMapper<Person> rowMapper = new BeanPropertyRowMapper<>(Person.class);
String sql = "select * from person where personId = '12'";
//下面這段代碼有問題，當(dāng)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'";
//下面這段代碼有問題，當(dāng)personId中12不存在，則會報異常EmptyResultDataAccessException
//Person person = jdbcTemplate.queryForObject(sql, rowMapper);
//使用mybatis替換queryForObject，mybatis查詢不到數(shù)據(jù)會返回null
Person person = rmbReportMapper.queryPersonBySql(sql);