Hibernate：对象内的Date属性无法保存至数据库

我之前也碰到过类似的JPA关联实体属性持久化后丢失的情况，结合你的描述，咱们一步步排查可能的原因和解决办法：

1. 检查实体类的属性映射配置 #

首先得确认ScheduleDateActiveItem类里的date属性有没有正确配置JPA注解：

• 是不是漏加了@Column注解？如果属性名和数据库列名不一致，必须指定name属性匹配，比如@Column(name = "active_date")
• 有没有误加transient关键字？一旦加了这个，JPA会直接忽略该属性的持久化操作
• 检查getter/setter方法是否正确实现？JPA依赖这些方法访问属性，方法名写错或者逻辑异常都会导致值无法存入

举个正确的示例：

public class ScheduleDateActiveItem {
    // 其他属性...
    @Column(name = "active_date")
    private LocalDate date;

    // 标准的getter/setter
    public LocalDate getDate() {
        return date;
    }

    public void setDate(LocalDate date) {
        this.date = date;
    }
}

2. 确认关联关系的映射配置 #

因为Schedule和ScheduleDateActiveItem是一对多关联，得确保关联注解配置无问题：

• 在Schedule类的列表属性上，是否添加了@OneToMany并正确设置cascade？比如@OneToMany(cascade = CascadeType.ALL, orphanRemoval = true)，如果没设置级联操作，保存Schedule时不会同步持久化子实体的属性
• 双向关联场景下，有没有正确设置mappedBy或@JoinColumn？错误的关联映射会导致JPA无法追踪子实体的归属，进而丢失属性值

比如Schedule类的正确配置：

public class Schedule {
    // 其他属性...
    @OneToMany(mappedBy = "schedule", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<ScheduleDateActiveItem> activeItems = new ArrayList<>();

    // 建议用这种方法维护双向关联关系
    public void addActiveItem(ScheduleDateActiveItem item) {
        activeItems.add(item);
        item.setSchedule(this); // 同步设置子实体的关联对象
    }
}

3. 检查事务配置 #

保存操作是否在事务中执行？如果没有开启事务，JPA的持久化上下文可能无法同步到数据库，导致部分属性未被持久化。确保你的保存方法上标注了@Transactional注解：

@Service
public class ScheduleService {
    private final ScheduleRepository scheduleRepository;

    public ScheduleService(ScheduleRepository scheduleRepository) {
        this.scheduleRepository = scheduleRepository;
    }

    @Transactional
    public Schedule saveSchedule(Schedule schedule) {
        return scheduleRepository.save(schedule);
    }
}

4. 核对数据库列的配置 #

查看数据库中对应的date列：

• 是不是被设置为允许为空？如果列是NOT NULL但JPA未写入值，理论上会抛出异常，但特殊配置（比如默认值）可能导致存入null
• 列类型是否和Java属性匹配？比如Java用LocalDate，数据库要对应DATE类型，而非VARCHAR等不兼容类型

5. 启用JPA日志排查细节 #

如果以上方法都没解决问题，可以开启JPA的SQL日志，查看实际执行的INSERT语句是否包含date字段。比如在application.properties中添加：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

通过日志能直接确认JPA是否将date值拼入了插入语句，快速定位是映射问题还是业务逻辑疏漏。

内容的提问来源于stack exchange，提问作者Daniel Haughton