Spring Boot+MySQL项目启动报错：找不到entityManagerFactory Bean

问题概述 #

基于CrudRepository/MySQL的Spring Boot应用启动时出现错误：A component required a bean named 'entityManagerFactory' that could not be found，更换驱动类、改用JpaRepository后问题仍存在。

关键错误原因分析 #

从提供的配置和代码来看，导致entityManagerFactory无法创建的核心原因有两个：

1. JPA数据库方言与实际数据库不匹配：配置中使用了H2数据库的方言，但实际连接的是MySQL，导致Hibernate无法正确初始化实体管理器工厂。
2. 手动引入Hibernate插件干扰Spring Boot自动配置：Spring Boot的spring-boot-starter-data-jpa已经内置了Hibernate的依赖和自动配置逻辑，手动添加org.hibernate.orm插件会导致版本冲突或自动配置失效。

具体修复步骤 #

1. 修正JPA数据库方言配置 #

修改application.properties中的spring.jpa.database-platform，替换为MySQL对应的方言：

# 替换原有的H2方言配置
spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect

说明：因为使用的是MySQL Connector/J 8.0.31，对应MySQL 8.x版本，所以使用MySQL8Dialect；如果是MySQL 5.x版本，可改为org.hibernate.dialect.MySQL5Dialect。

2. 移除多余的Hibernate插件 #

编辑build.gradle，删除以下插件配置行：

id "org.hibernate.orm" version "6.1.6.Final"

说明：Spring Boot的spring-boot-starter-data-jpa已经包含了适配版本的Hibernate依赖，手动添加该插件会破坏Spring Boot的依赖管理，导致自动配置流程异常。

3. 完善数据库连接信息 #

确保application.properties中的数据库用户名和密码正确填写（如果本地MySQL需要身份验证）：

spring.datasource.username=你的MySQL用户名（如root）
spring.datasource.password=你的MySQL密码

4. 检查枚举类定义 #

确认UserEntity中使用的UserRole枚举已经正确定义，示例如下：

public enum UserRole {
    ADMIN,
    USER,
    // 其他角色
}

说明：如果枚举类未定义，Hibernate在映射实体时会抛出异常，间接导致entityManagerFactory创建失败。

验证修复 #

完成以上修改后，重新启动应用：

• 检查控制台日志，确认没有entityManagerFactory相关错误
• 验证数据库表是否正常生成（根据spring.jpa.hibernate.ddl-auto=update配置）
• 测试UserRepository的查询方法是否正常工作

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