若依报错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 接收" 的开发原则,可彻底避免此类类型转换异常。

相关推荐
若兰幽竹16 分钟前
【从零开始编写数据库系统:架构设计与实现】第5章:查询执行引擎与火山模型
数据库·架构·数据库内核·toydb
天空属于哈夫克31 小时前
企业微信API常见的错误和解决方案
java·数据库·企业微信
东风破1371 小时前
DM8达梦数据库备份、恢复原理介绍
数据库·oracle·dm达梦数据库
鹏子训1 小时前
AI记忆新思路:用SQLite替代向量数据库,去EMBEDDINGS化,谷歌开源Google Always On Memory Agent
数据库·人工智能·sqlite·embedding
Frank_refuel1 小时前
终端环境下:Ubuntu 22.04.1 安装 MySQL 数据库
数据库·mysql·ubuntu
虹科网络安全3 小时前
艾体宝产品|深度解读 Redis 8.4 新增功能:原子化 Slot 迁移(下)
数据库·redis·bootstrap
有味道的男人4 小时前
对接亚马逊平台接口,商品全量信息一键抓取
数据库
Web极客码4 小时前
2026年Linux VPS安全加固清单:SSH、防火墙与审计就绪配置
运维·服务器·数据库
逻辑驱动的ken5 小时前
Java高频面试考点18
java·开发语言·数据库·算法·面试·职场和发展·哈希算法
qq_392690665 小时前
Redis怎样应对Redis集群整体宕机带来的雪崩
jvm·数据库·python