Hibernate关联PostgreSQL一对多表时Liquibase插入数据报错：relation 'onboarding_tasks'不存在的问题排查

1. 先解决「表不存在」的核心错误 #

你碰到的ERROR: relation "onboarding_tasks" does not exist是当前最直接的问题，本质是Liquibase执行INSERT脚本时，onboarding_tasks表还没被创建出来，常见原因和修复方式：

• Liquibase执行顺序错误：确保创建onboarding_tasks和onboarding_task_item表的changeSet，放在插入测试数据的changeSet之前执行。Liquibase是严格按changelog里的顺序依次执行的，先跑INSERT再建表必然报错。
• Hibernate与Liquibase执行时机冲突：如果你依赖Hibernate自动生成表（比如设置hibernate.hbm2ddl.auto=create/update），但Liquibase的执行时机早于Hibernate建表，也会触发这个错误。这种情况要么调整两者的执行顺序，要么改用Liquibase全权管理表结构创建，放弃Hibernate自动建表。

2. 修正实体类的一对多关联配置 #

你的实体类关联配置存在明显不匹配，会导致外键创建异常甚至表结构生成错误：

• 当前OnboardingTasks中@OneToMany的@JoinColumn(name = "onboarding_tasks")，和OnboardingTaskItem中@ManyToOne的@JoinColumn(name="task_id")，外键列名完全不一致，Hibernate无法正确建立关联关系。
• 按JPA最佳实践修正配置，统一外键列名并明确关联拥有方：

  // OnboardingTasks 类中
  @OneToMany(cascade = CascadeType.ALL, orphanRemoval = true, mappedBy = "onboardingTasks")
  private List<OnboardingTaskItem> onboardingTaskItems = new ArrayList<>(); // 变量名更贴合语义
  
  // OnboardingTaskItem 类中
  @ManyToOne
  @JoinColumn(name="task_id", nullable = false) // 子项必须属于父任务，添加nullable=false更合理
  private OnboardingTasks onboardingTasks;
  

  用mappedBy指定OnboardingTaskItem作为关联的拥有方，能避免Hibernate生成多余的关联列，也符合一对多关联的常规配置方式。

3. 修正SQL脚本与实体类的字段不匹配问题 #

你的INSERT脚本插入了business_name、meta_title、status、task_type、updated_at这些字段，但OnboardingTasks实体类里根本没有定义这些字段，这会导致：

• 如果依赖Hibernate自动建表，表中不会有这些列，执行INSERT时会报「列不存在」；
• 如果用Liquibase建表，会导致实体类和表结构不一致，后续ORM操作必然出错。
• 修正后的INSERT脚本（只插入实体类存在的字段）：

  INSERT into onboarding_tasks (title, created_at) 
  SELECT left (md5(random()::text), 10) AS title, 
  (NOW() + (random() * (NOW() + '90 days' - NOW())) + '30 days') AS created_at 
  FROM generate_series(1,355) as g(id)
  

关于@Eager注解的疑问 #

你提到的@Eager（实际是@Fetch(FetchType.EAGER)）只影响关联数据的加载策略（立即加载/懒加载），和当前的表不存在、关联配置错误、SQL脚本不匹配问题完全无关，不需要考虑用它来解决当前错误。

修复步骤总结 #

1. 调整Liquibase changelog顺序，确保建表操作在INSERT之前；
2. 修正实体类的一对多关联配置，统一外键列名并正确使用mappedBy；
3. 修正INSERT脚本，使其与实体类/表结构的字段匹配。

内容的提问来源于stack exchange，提问作者Peter Penzov