Spring Boot实体关系错误修复：entityManagerFactory创建失败无法映射集合

这个报错的核心问题很明确：你的JPA关联映射配置里，外键关联的实体主键字段名不匹配，导致Hibernate无法正确解析User和Role之间的多对多关系。

问题根源 #

看你的User类代码，它的主键字段是userId：

@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Long userId;

但你最初在@JoinTable的joinColumns配置中，写的是referencedColumnName = "id"——Hibernate找不到User实体里名为id的主键字段，自然无法映射roles集合，直接导致了entityManagerFactory初始化失败。

你的解决方案为什么有效 #

你修改后的配置完全命中了问题核心：

@ManyToMany(fetch = FetchType.EAGER, cascade = CascadeType.ALL)
@JoinTable(
    name = "users_roles",
    joinColumns = @JoinColumn(
        name = "user_userId", referencedColumnName = "userId"),
    inverseJoinColumns = @JoinColumn(
        name = "role_id", referencedColumnName = "id"))
public Collection<Role> roles;

这里做了两个关键修正：

1. 将referencedColumnName从id改为userId，和User实体的主键字段名完全匹配
2. 把中间表的外键列名从user_id改为user_userId，让列名和关联的实体主键字段名对应，既避免了歧义，也让数据库表结构更清晰

额外注意事项 #

• JPA映射对字段名大小写敏感，一定要确保referencedColumnName的值和实体类中的主键字段名完全一致
• 多对多关联的中间表外键列名，建议和关联实体的主键字段名保持关联（比如user_userId对应User的userId），后续维护起来更省心
• 检查所有实体的关联映射配置，避免出现类似的字段名不匹配问题

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