XML映射中的空值(null)和空字符串如何处理?

畫卷琴夢

畫卷琴夢

2026-03-21

422人浏览

原创

mybatis默认将数据库null映射为java属性默认值:基本类型抛异常,包装类和string为null;需显式配置jdbctype并用包装类型才能正确处理null,default属性对null无效。

xml映射中的空值(null)和空字符串如何处理?

MyBatis 中 resultMap 遇到数据库字段为 NULL 时默认行为

MyBatis 默认会把数据库的 NULL 值映射为 Java 对象对应属性的默认值:基本类型用零值(如 0false),引用类型(如 StringInteger)才可能为 null。但前提是你的 Java 字段声明是包装类或对象类型,且没配 jdbcType

常见踩坑点:

  • 字段声明为 String name,数据库值为 NULL → 映射后是 null;若声明为 String name = "" 或有构造函数赋初值 → 可能被覆盖成 null,也可能保留空字符串,取决于 setter 是否被调用
  • 字段是 int age,数据库为 NULL → MyBatis 无法赋值给基本类型,抛出 org.apache.ibatis.executor.result.ResultMapException
  • 没在 resultMap 中显式指定 jdbcType 的可空列,某些 JDBC 驱动(如 older MySQL Connector/J)可能返回 "" 而非 null,造成语义混淆

如何让 NULL 和空字符串在映射后可区分?

关键在于两件事:一是告诉 MyBatis “这个字段允许为 NULL”,二是避免空字符串被误当作有效值覆盖掉原本的 null 意图。必须显式配置 jdbcType 并配合合理的 Java 类型设计。

  • resultMap 中为可能为 NULL 的列加上 jdbcType,例如:
    <result column="nick_name" property="nickName" jdbctype="VARCHAR"></result>
  • Java 字段必须使用包装类型或 String,不能用 int / boolean 等基本类型
  • 如果业务上需要区分 “数据库 NULL” 和 “数据库存了空字符串”,仅靠 MyBatis 默认映射做不到 —— 它俩都会变成 Java 的 null""。此时需在 SQL 层做转换,比如:
    SELECT id, CASE WHEN nick_name IS NULL THEN '__NULL__' ELSE nick_name END AS nick_name FROM user
    ,再在 Java 层解析标记

MyBatis 的 default 属性对空值无效

<result></result> 标签的 default 属性**只在列名不存在或 ResultSet 无该列时生效**,它不处理 NULL 值。很多人误以为写 default="" 就能让 NULL 变成空字符串,实际完全不起作用。

真正可控的方式只有两种:

  • 在 SQL 中用 COALESCE(nick_name, '')IFNULL(nick_name, '') 强制转空字符串
  • 在 Java Bean 的 getter 中统一处理,例如:
    public String getNickName() {
        return nickName == null ? "" : nickName;
    }

Spring Boot + MyBatis-Plus 场景下的额外注意

MyBatis-Plus 的自动填充、逻辑删除、以及 @TableField(fill = ...) 都依赖字段是否为 null 判断是否触发。如果数据库字段允许 NULL,但你又在实体类里写了 private String remark = "";,那么即使查出来是 NULL,也会被初始化为空字符串,导致自动填充失效或条件判断出错。

建议做法:

  • 所有可能为 NULL 的字段,Java 层不做默认初始化,保持 private String remark;
  • 启用 MyBatis-Plus 的 configuration.call-setters-on-nulls=true(默认 false),确保 NULL 也会调用 setter,便于后续逻辑统一处理
  • 若用 @TableField(strategy = FieldStrategy.IGNORED),要清楚它跳过的是“非空判断”,不是“NULL 判断”——字段为 null 仍会参与更新,除非你手动设为 FieldStrategy.NOT_EMPTY
空值和空字符串的边界模糊,往往不是框架问题,而是数据库设计、SQL 编写、Java 类型选择三者没对齐。最易忽略的是:你以为在 Java 层设了默认值就能兜底,其实它早就在字段声明那一刻破坏了原始 NULL 语义。
PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

2474

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

449

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

615

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3991

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

1347

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

3563

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

3537

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

642

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

526

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.4万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 131.8万人学习