若依报错org.springframework.dao.DataIntegrityViolationException

org.springframework.dao.DataIntegrityViolationException: Error attempting to get column 'sfz' from result set. Cause: java.sql.SQLDataException: Cannot determine value type from string '2222222222XXXXXX'

且报错信息中对应表里第一个字段sfz直接报出来

直接找到对应xml里写的SQL,肯定是 指定的 resultType 和 SQL查询所 返回的数据类型不一致 , 例如下面这种情况:

一、报错核心含义解析

这个报错是数据库结果集与 Java 实体类的类型映射异常,拆解后核心信息如下:

  1. org.springframework.dao.DataIntegrityViolationException :Spring 封装的数据完整性异常 ,此处并非主键冲突 / 非空约束等传统完整性问题,而是结果集字段类型转换失败导致的 "逻辑上的数据完整性破坏";
  2. Error attempting to get column 'sfz' from result set :从数据库结果集中读取列名sfz(身份证号)的值时出错;
  3. java.sql.SQLDataException: Cannot determine value type from string '2222222222XXXXXX' :JDBC 驱动无法将字符串值2222222222XXXXXX(含字母 / 特殊字符的身份证号)转换为 Java 实体类中sfz字段的目标类型,本质是类型不匹配

简单来说:Java 实体类中sfz字段的类型,与数据库sfz列的字符串值(含非数字字符)无法兼容,JDBC 驱动无法完成自动类型转换,从而抛出异常

二、典型判断

看到该报错可立刻做出以下核心判断:

  1. 根因是「类型映射不匹配」 :实体类中sfz字段的类型不是字符串(String ,而是数字类型(Long/Integer/BigDecimal),但数据库中sfz列存储的是含XXXX等非数字字符的字符串,无法转换为数字类型;
  2. 非数据库存储异常 :数据库中sfz列的类型本身是字符型(VARCHAR/CHAR),存储值无问题,问题出在Java 端的类型接收
  3. 映射层面的错误 :要么是 MyBatis/MyBatis-Plus 的自动映射规则错误,要么是手动配置的ResultMapsfz列映射到了非字符串类型的字段;
  4. 数据特征触发sfz值含XXXX(身份证号脱敏后的字符)是关键,若为纯数字可能不会报错,非数字字符直接暴露了类型不匹配的问题。

解决:

该报错的核心是实体类sfz字段类型与数据库字符串值不匹配,解决优先级为:

  1. 将实体类中sfz字段改为String类型;
  2. 修正 MyBatis ResultMap的类型映射配置;
  3. 若使用自定义类型,添加对应的类型处理器;
  4. 修正数据库列类型(若为数字类型)。

通过规范 "字符型字段用 String 接收" 的开发原则,可彻底避免此类类型转换异常。

相关推荐
默 语2 小时前
RAG实战:用Java+向量数据库打造智能问答系统
java·开发语言·数据库
dazhong20122 小时前
Mybatis 敏感数据加解密插件完整实现方案
java·数据库·mybatis
薛晓刚2 小时前
2025 年度个人回顾总结
数据库
TDengine (老段)2 小时前
TDengine 在智能制造领域的应用实践
java·大数据·数据库·制造·时序数据库·tdengine·涛思数据
嘻哈baby2 小时前
MySQL索引设计避坑指南:这些错误别再犯了
mysql
男孩李2 小时前
浅谈PostgreSQL 模式(SCHEMA)
数据库·postgresql
q_19132846952 小时前
基于Springboot+Vue.js的工业人身安全监测系统
vue.js·spring boot·后端·mysql·计算机毕业设计·串口通讯
TG:@yunlaoda360 云老大3 小时前
如何在华为云国际站代理商控制台进行基础状态核查的常见问题解答
数据库·华为云·php
CeshirenTester3 小时前
Cursor自动调试代码实战教程
数据库·oracle