Java JPA项目创建EntityManager报JdbcEnvironment创建失败如何解决

错误原因 #

导致Unable to create requested service [org.hibernate.engine.jdbc.env.spi.JdbcEnvironment]报错的核心问题有3个：

1. persistence.xml配置存在拼写错误：你配置的javax.persistence.jdcb.driver属性名拼写错误，正确应为javax.persistence.jdbc.driver，无效属性名导致Hibernate无法读取JDBC驱动配置，无法初始化数据库连接环境。
2. 实体类字段映射完全错误：Reunion类中三个字段的@Column(name)全部填成了"id"，既重复映射了主键字段，也和实际数据表的date、subject字段完全不匹配。
3. 其他可能的附加原因：未引入MySQL JDBC驱动依赖、MySQL服务未启动、数据库账号密码配置错误、MySQL版本与驱动版本不匹配。

排查解决步骤 #

• 第一步：修正persistence.xml的拼写错误，同时根据你的MySQL版本适配配置

<!-- 原有错误配置 -->
<!-- <property name="javax.persistence.jdcb.driver" value="com.mysql.jdbc.Driver" /> -->

<!-- 替换为对应版本的正确配置 -->
<!-- MySQL 5.x版本 -->
<property name="javax.persistence.jdbc.driver" value="com.mysql.jdbc.Driver" />
<property name="javax.persistence.jdbc.url" value="jdbc:mysql://localhost:3306/reunion?useUnicode=true&characterEncoding=utf8" />

<!-- MySQL 8.0+版本 -->
<property name="javax.persistence.jdbc.driver" value="com.mysql.cj.jdbc.Driver" />
<property name="javax.persistence.jdbc.url" value="jdbc:mysql://localhost:3306/reunion?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC&useSSL=false" />

• 第二步：修正实体类的字段映射，和数据表字段一一对应

import java.util.Date;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;
import javax.persistence.Temporal;
import javax.persistence.TemporalType;

@Entity
@Table(name = "reunion")
public class Reunion {
    
    @Column(name = "id")
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;

    // 对应数据库date字段，指定日期类型
    @Column(name = "date")
    @Temporal(TemporalType.TIMESTAMP)
    private Date fecha;

    // 对应数据库subject字段
    @Column(name = "subject")
    private String asunto;

    // 原有getter、setter方法保持不变
}

• 第三步：检查项目依赖
  确认构建配置（pom.xml/build.gradle）中已引入对应版本的MySQL驱动依赖，以Maven为例：

<!-- MySQL 5.x对应驱动 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.49</version>
</dependency>

<!-- MySQL 8.0+对应驱动 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
</dependency>

• 第四步：验证数据库基础信息
  确认MySQL服务正常启动、3306端口可访问、reunion数据库已创建、配置的root账号密码正确，且root账号有本地访问reunion库的权限。

内容的提问来源于stack exchange，提问作者Juan Fernando Huenchun