Spring EclipseLink未正确删除关联表行：关联列绑定为null

问题根源 #

从EclipseLink执行日志可以明确看到：执行DELETE语句时USERNAME参数绑定值为null，这直接导致WHERE条件无法匹配任何记录，关联表USER_ROLES里的旧角色关联自然删不掉。

问题出在User实体的@JoinTable配置上：你指定了joinColumns = @JoinColumn(name = "USERNAME", referencedColumnName = "USERNAME")，但如果User实体的主键不是userName字段（比如常见的自增id主键），EclipseLink会无法正确获取当前用户的userName值，最终绑定参数时出现null。

解决方案 #

方案1：修正关联字段映射（推荐） #

如果User的主键不是userName，将referencedColumnName改为User实体的主键字段名。假设User主键是id，修改代码如下：

@ManyToMany
@JoinTable(
  name = "USER_ROLES",
  joinColumns = @JoinColumn(name = "USERNAME", referencedColumnName = "id"), // 替换为实际主键字段
  inverseJoinColumns = @JoinColumn(name = "ROLE_ID")
)
private List<Role> roles = new ArrayList<>();

注意：需确保数据库USER_ROLES表的USERNAME字段实际存储的是User主键值，若不一致需同步调整表结构。

方案2：将userName设为实体主键 #

如果业务允许，直接把userName设为User实体的主键：

@Id
@Column(name = "USERNAME")
private String userName;

这样EclipseLink会自动识别该字段为关联依据，参数绑定不会再出现null。

方案3：手动维护关联关系 #

在DAO层的更新方法里，先清除旧关联再添加新角色：

public void update(User updatedUser) {
    // 加载数据库中已存在的用户实例
    User existingUser = entityManager.find(User.class, updatedUser.getId());
    // 清除旧角色关联并立即刷入数据库
    existingUser.getRoles().clear();
    entityManager.flush();
    // 添加新角色并合并更新
    existingUser.getRoles().addAll(updatedUser.getRoles());
    entityManager.merge(existingUser);
}

验证 #

修改后重新执行更新操作，查看EclipseLink日志，确认DELETE语句的USERNAME参数绑定的是实际用户名（而非null），此时USER_ROLES表中多余的角色关联记录会被正确删除。

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