若依报错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 的自动映射规则错误,要么是手动配置的ResultMap将sfz列映射到了非字符串类型的字段;
  4. 数据特征触发 :sfz值含XXXX(身份证号脱敏后的字符)是关键,若为纯数字可能不会报错,非数字字符直接暴露了类型不匹配的问题。

解决:

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

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

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

相关推荐
IvorySQL8 小时前
PostgreSQL 日报|修复截断 zstd 备份检测(10 月 9 日)
数据库·postgresql
刘胡子大叔8 小时前
SQL 脚本的导入顺序
数据库·sql
代码什么用9 小时前
Spring对IoC的实现
数据库·spring
hz5678911 小时前
涉密视频会议设备配置指南:终端、音视频采集与配套设施选型
服务器·网络·数据库·安全·实时音视频·信息与通信·智能硬件
广州浮点FLOATLIC11 小时前
许可证服务器迁移后软件打不开:研发 IT 怎样定位连接问题
linux·服务器·数据库
程序员Sunday11 小时前
MySQL 为什么使用 B+ 树索引?把范围查询、回表和覆盖索引连起来
数据库·mysql
半杯咖啡半行码11 小时前
Qt开发实战:数据库、MV 模式、QProcess与串口通信全攻略
数据库·qt
Yyyyyy~11 小时前
[ Mysql ] 库的操作
mysql
小米里的大麦12 小时前
16 MySQL 事务
数据库·mysql
西柚小萌新12 小时前
【LLM&&AI应用开发 八股文】--4.3.Agent智能体(下)
java·开发语言·数据库