说实话,这种“明明数据库里数据在那儿,代码一跑出来就是空”的坑,我在做后台管理系统开发的时候,没少踩。这绝对是开发过程中最让人抓狂的“隐形杀手”之一。咱们今天就来聊聊这个事儿,怎么把这个问题给彻底揪出来,并且一次性解决掉,以后再也不用在这种低级错误上浪费时间。
1. 问题的“灵魂拷问”:为什么数据会消失?
首先,你得明白MyBatis是怎么工作的。它本质上是一个SQL的执行器和结果映射器。当你写好一个SQL,比如 SELECT * FROM user WHERE id = 1,数据库老老实实返回了一行数据,但是到了你的Java对象里,比如 User 对象,属性全是空的。
这通常不是SQL写错了(因为你能查到空,说明SQL执行了),而是MyBatis不知道怎么把数据库里的那一堆列(column),变成你Java类里的属性(property)。
最常见的情况就是命名不匹配。数据库里通常是下划线风格,比如 user_name,而Java实体类里习惯用驼峰,比如 userName。MyBatis默认情况下是傻傻地直接匹配列名的,它不会自动把 user_name 转换成 userName。一旦匹配不上,它就会觉得“这个列没东西给我”,于是你的对象就空了。
2. 两种“流派”的解决方案
解决这个问题,咱们通常有两种思路:一种是“偷懒”的配置法,一种是“严谨”的映射法。
方案一:全局开启驼峰命名(适合快速开发)
如果你不想在每一个XML里都写一大堆 <resultMap>,你可以在配置文件里加一行配置。这就像是给MyBatis装了一个“翻译官”,告诉它:“看见下划线就给我自动转驼峰”。
在 application.yml 或者 mybatis-config.xml 里,加这么一段:
mybatis:
configuration:
# 开启驼峰命名自动映射,从数据库字段 user_name 自动映射到 Java 属性 userName
map-underscore-to-camel-case: true
效果:
只要你的数据库字段和Java属性命名规则符合“下划线转驼峰”,MyBatis就能自动匹配,你根本不需要写 resultMap。
但是! 这种方法有个巨大的隐患。如果你有时候字段是 user_name,有时候是 userName,或者有时候有表别名,这个全局配置就会出乱子,导致某些查询莫名其妙返回空。
方案二:手写 ResultMap(适合复杂系统)
在后台管理系统里,数据结构往往比较复杂,表关联也多。为了保险起见,我还是强烈建议大家使用显式的 resultMap。这虽然看起来代码多了一点点,但它是可控的,出了问题你能一眼看出来是哪一列没配对。
3. 代码实战:ResultMap 到底该怎么写?
咱们来模拟一个真实的后台管理场景。假设我们有一个 sys_user 表,字段是 user_id, user_name, dept_id。我们的 Java 实体类是 SysUser。
错误示范(为什么查出来是空)
很多新手会这样写Mapper XML:
<!-- 这里的 resultType 只是告诉 MyBatis 把结果转成 SysUser 对象 -->
<select id="selectUserById" resultType="com.example.demo.entity.SysUser">
select user_id, user_name, dept_id from sys_user where user_id = #{userId}
</select>
问题分析:
MyBatis 看到 resultType="SysUser",它会尝试在 SysUser 类里找 user_id、user_name、dept_id 这些属性。但是你的类里定义的是 userId、userName、deptId。名字对不上,MyBatis 就只能把查出来的数据扔回空,啥也映射不了。
正确示范(使用 ResultMap)
我们要显式地告诉MyBatis:“数据库的 user_id 对应 Java 的 userId”。
<!-- 定义一个 ResultMap,起个名字,以后好用 -->
<resultMap id="userResultMap" type="com.example.demo.entity.SysUser">
<!-- id 标签非常重要,通常对应主键,用于优化查询 -->
<id property="userId" column="user_id" />
<!-- result 标签用于普通字段的映射 -->
<result property="userName" column="user_name" />
<!-- 如果有其他字段,继续加 result 标签 -->
<result property="deptId" column="dept_id" />
</resultMap>
<!-- 在 SQL 中引用这个 ResultMap -->
<select id="selectUserById" resultMap="userResultMap">
select user_id, user_name, dept_id
from sys_user
where user_id = #{userId}
</select>
4. 进阶:处理更复杂的情况
在实际的后台管理系统开发中,我们经常遇到 One(一对一)或者 Many(一对多)的关系。
举个例子,一个订单(Order)对应一个用户(User)。我们需要查订单的时候,顺便把下单用户的名字也查出来。
这时候,resultMap 就要开始“秀操作”了,我们可以使用 association 和 collection 标签。
场景:订单表 order,用户表 sys_user。
<resultMap id="orderResultMap" type="com.example.demo.entity.Order">
<!-- 订单本身的字段映射 -->
<id property="orderId" column="order_id" />
<result property="orderNo" column="order_no" />
<!-- 核心来了:一对一映射 -->
<!-- property="user" 指的是 Order 类里的一个 User 类型的属性 -->
<!-- javaType="com.example.demo.entity.SysUser" 指的是这个属性的类型 -->
<association property="user" javaType="com.example.demo.entity.SysUser">
<id property="userId" column="user_id" />
<result property="userName" column="user_name" />
</association>
</resultMap>
<!-- SQL 查询:这里需要把两个表连起来查,或者分步查 -->
<select id="getOrderWithUser" resultMap="orderResultMap">
SELECT
o.order_id, o.order_no, o.user_id,
u.user_name
FROM sys_order o
LEFT JOIN sys_user u ON o.user_id = u.user_id
WHERE o.order_id = #{orderId}
</select>
5. 避坑指南:Debug 的技巧
有时候你觉得自己配置得没错,但数据还是空的,这时候千万别硬猜,要用技术手段去验证。
技巧一:开启 MyBatis 的 SQL 日志
在 application.yml 里把日志级别调成 DEBUG。这样你就能看到 MyBatis 真正执行的 SQL 是什么样子的,以及它生成的映射日志。
logging:
level:
com.example.demo.mapper: DEBUG
技巧二:检查数据库字段大小写
在某些数据库(如 Oracle)或者配置下,字段名是区分大小写的。MyBatis 默认是忽略大小写的,但如果你显式指定了 column="USER_ID",而数据库里是 user_id,那也会查不到。
技巧三:使用 @Alias 或者 @Column 注解
如果你不想在 XML 里写很多 result 标签,可以在 Java 实体类上加注解,实现“显式声明”和“自动映射”的结合。
public class SysUser {
@TableId(type = IdType.AUTO)
private Long userId;
// 显式告诉 MyBatis 数据库字段叫 user_name
@TableField("user_name")
private String userName;
// 如果不加注解,MyBatis 也会尝试自动映射,但加上更保险
}
总结
遇到 MyBatis 查询为空,先别急着怀疑人生,更别急着改代码。第一步,看日志,看 SQL 执行情况;第二步,看 Java 实体类的属性名和数据库字段名是不是“对不上号”;第三步,果断使用 <resultMap> 来显式管理映射关系,特别是涉及到表关联的时候。
搞定了这个,你的后台管理系统查询效率和安全系数都会上一个台阶。希望这篇分享能帮你在开发路上少走弯路,周五准时下班!
