EclipseLink @CascadeOnDelete注解失效问题排查求助

我之前也踩过EclipseLink @CascadeOnDelete的坑，结合你描述的情况（2.6.3版本、手动加数据库级联才生效），大概率是这几个原因导致的，咱们一步步来排查：

1. DDL生成策略没配置对，注解没生成数据库约束 #

@CascadeOnDelete的核心作用之一是让EclipseLink在生成表结构时，自动给子表的外键加上ON DELETE CASCADE约束。但如果你的EclipseLink没有被配置为生成/更新DDL，那这个注解就无法在数据库层面生效，删除父实体时自然会触发外键约束异常。

检查方法：
打开你的persistence.xml，找eclipselink.ddl-generation这个属性，确保它的值是create、create-drop或者update（如果是none的话，EclipseLink不会修改数据库表结构）。

比如正确的配置应该是：

<property name="eclipselink.ddl-generation" value="update"/>

如果你的表是手动创建的，那即使注解加对了，EclipseLink也不会自动给你加约束——这时候你手动加ON DELETE CASCADE有用，正好印证了这一点。

2. 注解的位置加错了 #

EclipseLink的@CascadeOnDelete有严格的位置要求：必须加在父实体的@OneToMany关联字段上（双向关系中），而不是子实体的@ManyToOne上。

举个正确的示例：

@Entity
public class Parent {
    @Id
    private Long id;

    // 正确：@CascadeOnDelete加在父实体的OneToMany上
    @OneToMany(mappedBy = "parent")
    @CascadeOnDelete
    private List<Child> children;
}

@Entity
public class Child {
    @Id
    private Long id;

    @ManyToOne
    private Parent parent;
}

如果你把注解加到了Child的@ManyToOne上，EclipseLink不会识别这个配置，自然不会生成级联约束。

3. ORM.xml的配置覆盖了注解 #

你提到orm.xml里有数据库链接地址，那要注意：ORM.xml的配置优先级高于Java注解。如果你的orm.xml里对该关联关系做了配置，但没有开启级联删除，那注解的设置会被覆盖。

比如如果orm.xml里有这样的配置：

<entity class="com.yourpackage.Parent">
    <attributes>
        <one-to-many name="children" mapped-by="parent">
            <!-- 这里缺少cascade-on-delete配置 -->
        </one-to-many>
    </attributes>
</entity>

那你需要在<one-to-many>标签里加上<cascade-on-delete/>，或者设置cascade-on-delete="true"，才能让级联删除生效。

4. 双向关联关系没维护好 #

有时候即使数据库有级联约束，或者EclipseLink应该在运行时级联删除，但如果你的双向关联没维护到位，也会出问题。比如：

• 添加Child到Parent时，没有同时设置Child的parent属性为当前Parent对象
• 删除Parent时，Parent的children集合没有包含所有关联的Child实体
• 关联关系的fetch类型是LAZY，删除时EclipseLink没有加载到子实体

解决方法：

• 维护双向关联时，写一个工具方法，比如在Parent里加addChild(Child child)，同时设置child.setParent(this)
• 删除Parent前，确保加载了所有关联的Child（比如用entityManager.find(Parent.class, id, FetchGraph)手动指定加载子实体，或者把fetch设为EAGER）

总结 #

按照这个顺序排查：先确认DDL生成策略是否让注解生效，再检查注解位置，然后核对ORM.xml的配置，最后确认关联关系的维护——应该就能找到问题所在了。

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