You need to enable JavaScript to run this app. Hibernate级联保存OneToMany关联时出现Data truncation异常
优惠活动
大模型
产品
解决方案
定价
更多

Hibernate级联保存OneToMany关联时出现Data truncation异常

实体关联配置错误导致的数据截断问题解决方案

首先明确结论:该问题完全与数据库UTF编码设置无关,所有根因都来自JPA实体关联映射的配置错误。

核心问题根因

你日志里看到的异常值'\xAC\xED\x00\x05sr\x00&it.***.checklist.models.calendar.Event...',是Java对象标准序列化后的二进制流,根本不是eventId列要求的整数外键值,触发数据截断的逻辑链如下:

  • RecurringPattern实体中,对Event类型的字段仅使用了@Column(name = "eventId")注解做映射,没有配置正确的对象关联规则
    • @Column注解仅支持映射数据库原生类型(整数、字符串、日期等),不支持将Java实体对象直接映射为数据库列值
    • JPA无法识别这个字段是外键关联关系时,会将Event对象按照可序列化的默认处理逻辑,序列化为二进制流尝试写入eventId列,刚好该列是MySQL的int类型,直接触发Data truncation异常
  • Event实体中配置的@OneToMany单向关联不完整,没有明确关联的维护边界,导致JPA无法正确感知双向关联的外键映射关系

具体修正步骤

  1. 修正RecurringPattern实体中的错误字段映射
    把原有错误的@Column配置替换为标准的多对一关联注解:

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "eventId", referencedColumnName = "id", nullable = false)
    private Event event;
    

    这里的@JoinColumn会明确告诉JPA,当前表的eventId列是关联Event表主键的外键,写入时会自动取event对象的id值填充,不会再序列化整个对象。

  2. 补全Event实体的一对多关联配置
    双向关联必须通过mappedBy明确关联关系的维护方,避免JPA自动生成不必要的中间关联表:

    @OneToMany(mappedBy = "event", cascade = {CascadeType.PERSIST, CascadeType.ALL}, fetch = FetchType.EAGER)
    List<RecurringPattern> recurringPatterns;
    
  3. 调整关联维护逻辑的兼容性
    你原有Event类中设置的私有setRecurringPatterns方法,会和Lombok @Data生成的公共setter产生冲突,保留你手写的addRecurringPattern双向关联绑定逻辑即可,避免外部直接set集合破坏关联一致性。

为什么save()方法调用时没有抛出异常

Hibernate不会在调用save()方法的瞬间就把所有SQL下发到数据库,而是等整个事务提交、执行脏检查刷库阶段才会真正执行写操作。你遇到的异常就是在刷库阶段才触发的,所以调试时会误以为save()方法执行没有问题。


内容的提问来源于stack exchange,提问作者Pickeroll

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 16:36:04