Spring Boot 应用无法创建数据库表？这份指南帮你排查！

Spring Boot 应用无法在 MySQL 数据库中创建表？这份指南帮你排查！

你兴致勃勃地为你的在线商店开发新的后端 API，商品、购物车、用户等实体类都已创建完毕。满怀期待地运行应用程序，却发现数据库中一片空白，说好的表呢？更糟糕的是，日志中没有任何错误信息输出，你仿佛置身迷宫，完全找不到方向。

别慌，你不是一个人！许多开发者在使用 Spring Boot 和 MySQL 时都曾被这个问题困扰。本文将为你逐一排查问题根源，并提供有效的解决方案，助你迅速解决这个拦路虎。

一、数据库配置：地基要打牢

万丈高楼平地起，首先要确保你的数据库配置正确无误。打开 application.properties 文件，仔细检查以下关键配置项：

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/OnlineShop
spring.datasource.username=root
spring.datasource.password=franklampard08@

• 驱动类名 (driver-class-name): 如同汽车需要正确的型号才能启动，这里要确保使用与你的 MySQL 版本兼容的驱动类名。
• 连接 URL (url): 这就好比填写收货地址，数据库地址、端口号以及数据库名称，一个都不能错。
• 用户名和密码 (username/password): 这就好比进入数据库的钥匙，仔细检查用户名和密码是否正确，任何拼写错误都会让你被拒之门外。

二、数据库连接：确保通路畅通

确认配置无误后，我们需要测试应用程序是否能够成功连接到数据库。你可以编写一个简单的测试类，尝试连接数据库并执行简单的查询操作。如果连接失败，控制台会输出相应的异常信息，如同指南针为你指明方向，根据异常信息进行调整即可。

@SpringBootTest
public class DatabaseConnectionTest {

    @Autowired
    private DataSource dataSource;

    @Test
    void testConnection() throws SQLException {
        try (Connection connection = dataSource.getConnection()) {
            Assertions.assertNotNull(connection);
        }
    }
}

三、实体类注解：身份信息要标注清晰

接下来，我们需要检查你的实体类注解是否正确。以你提供的 User 实体类为例：

@Entity
@Table(name= "user")
public class User {
    // ...
}

• @Entity 注解：如同身份证，告诉 Spring Boot 将该类视为一个实体类。
• @Table(name = "user") 注解：如同户口本，指定了该实体类对应的数据库表名为 "user"。

确保你的实体类中使用了正确的注解，并且表名与数据库中预期的表名一致，避免出现“张冠李戴”的情况。

四、Hibernate 自动创建表策略：开启自动模式

Spring Boot 默认情况下不会自动创建数据库表，你需要手动开启“自动挡”。在 application.properties 文件中配置 Hibernate 的 ddl-auto 属性：

spring.jpa.hibernate.ddl-auto=update

• update 策略：如同开启了自动模式，Hibernate 会根据实体类的定义自动创建或更新数据库表结构。

五、依赖项：工具箱要备齐

确保你的项目中包含了所有必要的依赖项，如同进行装修，缺少了锤子或钉子都无法完成工作。在你的 pom.xml 文件中，应该包含以下依赖项：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
</dependency>

• spring-boot-starter-data-jpa 依赖：提供了 Spring Data JPA 的支持，如同装修队的核心成员。
• mysql-connector-j 依赖：提供了连接 MySQL 数据库所需的驱动程序，如同连接水管的工具。

六、排查其他问题：排除万难

如果以上步骤都无法解决问题，你可能需要进一步排查其他原因，如同仔细检查装修过程中每个细节：

• 数据库权限问题： 确认你的数据库用户拥有创建表的权限，如同拥有进入房间的钥匙。
• 防火墙问题： 检查防火墙设置是否阻止了应用程序与数据库之间的连接，如同检查门窗是否被封死。
• 版本兼容性问题： 确保你使用的 Spring Boot、Hibernate 和 MySQL 版本之间相互兼容，如同不同型号的家具尺寸要匹配。

总结：拨云见日

通过以上步骤，相信你已经成功解决了 Spring Boot 应用无法在 MySQL 数据库中创建表的问题。记住，在开发过程中，仔细检查配置、注解和依赖项至关重要，如同建造房屋要关注每一个细节。同时，学会查看日志信息也是排查问题的重要手段，如同根据地图和指南针找到正确方向。

常见问题解答

1. 为什么我的 ddl-auto 设置为 update 后，数据库中仍然没有创建表？

• 检查数据库连接是否正常，以及数据库用户是否拥有创建表的权限。
• 确认实体类注解是否正确，特别是 @Entity 和 @Table 注解。
• 检查项目中是否包含了 spring-boot-starter-data-jpa 依赖。

2. 除了 update 策略，还有哪些常用的 ddl-auto 策略？

• create：每次启动应用程序时都会重新创建数据库表结构，原有数据会被清空。
• create-drop：在应用程序启动时创建表结构，在应用程序关闭时删除表结构。
• validate：验证实体类与数据库表结构是否一致，如果不一致则抛出异常。
• none：不进行任何操作，默认值。

3. 如何查看 Hibernate 执行的 SQL 语句？

• 在 application.properties 文件中添加以下配置项：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

• 这会将 Hibernate 执行的 SQL 语句打印到控制台。

4. 如何指定实体类生成表的字符集和排序规则？

• 在 @Table 注解中使用 charset 和 collation 属性：

@Entity
@Table(name = "user", charset = "utf8mb4", collation = "utf8mb4_unicode_ci")
public class User {
    // ...
}

5. 如何解决 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver 报错？

• 检查项目中是否包含了 mysql-connector-j 依赖，确保版本兼容。
• 如果使用的是较老版本的 Spring Boot，可以尝试将驱动类名改为 com.mysql.jdbc.Driver。