Spring Boot集成Google API项目连接MySQL数据库失败排查

我完全懂你现在的困扰——官方示例加个时区参数就搞定了JDBC问题，但自己的项目不仅连不上数据库，还爆了entityManagerFactory创建失败的错误，这确实让人头疼。咱们一步步拆解排查，把问题解决掉：

一、先解决核心的JDBC连接问题 #

entityManagerFactory创建失败很多时候是JDBC连接异常的连锁反应，先把数据库连接的坑填上：

1. 修正数据库URL的关键参数 #

MySQL 8.0+版本强制要求指定时区，否则会触发连接兼容性问题。你的原有URL缺少必要参数，改成下面这样：

spring.datasource.url=jdbc:mysql://localhost:8181/testuser?serverTimezone=UTC&useSSL=false&allowPublicKeyRetrieval=true

• serverTimezone=UTC：解决时区不匹配导致的连接拒绝
• useSSL=false：本地开发环境关闭SSL验证（生产环境按需开启）
• allowPublicKeyRetrieval=true：解决部分环境下的公钥检索失败问题

2. 验证数据库服务可用性 #

用命令行直接测试数据库连接，排除服务本身的问题：

mysql -h localhost -P 8181 -u root -p

如果连接失败，先检查：

• MySQL服务是否正常启动
• 端口8181是否是实际监听的端口
• 用户名root和密码root是否正确

二、修复Hibernate配置不兼容问题 #

你的配置里驱动和方言版本不匹配，这会直接导致entityManagerFactory初始化失败：

1. 替换Hibernate方言 #

你用的是MySQL 8.x的驱动com.mysql.cj.jdbc.Driver，但方言还是旧的MySQL5Dialect，改成对应版本的方言：

spring.jpa.properties.hibernate.dialect = org.hibernate.dialect.MySQL8Dialect

MySQL8方言适配了新版本的SQL语法和特性，旧方言会导致Hibernate生成不兼容的SQL。

三、检查实体类与Repository的配置细节 #

如果上面的步骤还没解决，就要检查代码层面的配置遗漏：

1. 实体类注解是否规范 #

确保UsersDevo类的注解正确，Spring能识别为持久化实体：

@Entity
@Table(name = "users_devo") // 如果数据库表名和类名不一致，必须指定
public class UsersDevo {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY) // 适配MySQL自增主键
    private Long userId;
    
    // 其他字段、getter/setter方法
}

注意：如果你的ddl-auto=none，要确保数据库中已经存在对应的数据表，且字段名、类型和实体类完全匹配。

2. Repository接口与包扫描配置 #

• 确保UsersRepo继承正确的Spring Data JPA接口：

@Repository
public interface UsersRepo extends JpaRepository<UsersDevo, Long> {
    // 自定义查询方法（如果有）
}

• 主类要确保能扫描到实体类和Repository：

@SpringBootApplication
@EntityScan(basePackages = "com.yourpackage.entity") // 替换成你的实体类包路径
@EnableJpaRepositories(basePackages = "com.yourpackage.repository") // 替换成你的Repository包路径
public class TestspringsecuApplication {
    public static void main(String[] args) {
        SpringApplication.run(TestspringsecuApplication.class, args);
    }
}

如果实体类和Repository不在主类的子包下，必须手动指定扫描路径。

四、确认依赖版本兼容性 #

检查pom.xml中的依赖是否匹配：

• Spring Boot 2.x搭配MySQL驱动：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version> <!-- 建议使用Spring Boot默认管理的版本 -->
</dependency>

• Spring Boot 3.x搭配MySQL驱动（artifactId已变更）：

<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.0.33</version>
</dependency>

同时确保spring-boot-starter-data-jpa依赖已正确引入。

按照这个流程排查下来，基本能解决JDBC连接失败和entityManagerFactory创建异常的问题。

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