Spring Boot JPA 实体扫描失败导致数据库表未自动创建的解决方案

spring boot 启动时未创建 jpa 实体对应的数据表，根本原因通常是实体类未被正确扫描到——默认情况下，`@springbootapplication` 仅扫描主类所在包及其子包，而你的 `@entity` 类位于独立的 `model` 包中，未被自动发现。

在 Spring Boot 中，@SpringBootApplication 是一个组合注解，等价于 @Configuration + @EnableAutoConfiguration + @ComponentScan。其中 @ComponentScan 默认只扫描主启动类所在包及其子包下的组件（包括 @Entity、@Repository、@Service 等）。而你的项目结构如下：

• 启动类 LibraryApplication 位于 projectlibrary.library 包
• 所有实体类（Book, Borrower, Employee, User）均位于 model 包（与 projectlibrary 平级）

因此，JPA 无法识别这些实体，spring.jpa.hibernate.ddl-auto=update 也就无从生效——没有实体被加载，自然不会生成任何表。

✅ 正确解决方案有两种（推荐第二种，更清晰可控）：

方案一：调整包结构（简单但牺牲模块化）

将 model 包移入 projectlibrary 下，例如改为 projectlibrary.model，并同步更新所有类的 package 声明。此时无需额外配置，@ComponentScan 默认即可覆盖。

方案二：显式声明实体与仓库扫描路径（推荐 ✅）

在启动类上添加 @EntityScan 和 @EnableJpaRepositories，明确指定实体和仓库所在包：

package projectlibrary.library;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication
@EntityScan(basePackages = "model") // ← 关键：显式扫描 model 包下的 @Entity
@EnableJpaRepositories(basePackages = "repository") // ← 若你有自定义 Repository 接口，也需指定（如无，可省略）
public class LibraryApplication {
    public static void main(String[] args) {
        SpringApplication.run(LibraryApplication.class, args);
    }
}

⚠️ 注意事项：@EntityScan 仅负责扫描 @Entity 类；若你还定义了 @Repository 接口（如 BookRepository extends JpaRepository），且它们不在 projectlibrary.library 或其子包中，也必须通过 @EnableJpaRepositories(basePackages = "...") 显式声明。确保 application.properties 中 spring.jpa.hibernate.ddl-auto 值有效：create（每次启动重建）、update（增量更新）、validate（仅校验）或 none（禁用）。开发阶段建议暂用 create-drop 或 update，上线前务必改为 validate 或 none 并配合 Flyway/Liquibase 进行版本化迁移。检查 MySQL 连接是否真正成功：可在 application.properties 中添加 logging.level.org.springframework.jdbc=DEBUG 查看连接日志；同时确认数据库 Library 已存在、用户权限已正确授予（你提供的 SQL 脚本是正确的）。@Id 字段类型需匹配主键策略：Book.ean 是 St

ring，但你未声明生成策略（如 @GeneratedValue 不适用于字符串主键），这是合理的（EAN 通常手动赋值），但需确保业务层不依赖自增逻辑；而 User.id 使用了 GenerationType.IDENTITY，要求数据库列设为 AUTO_INCREMENT，请确认 USER 表主键已正确定义。

完成上述配置后重启应用，Hibernate 将成功加载所有实体，并根据 ddl-auto=update 自动创建 USER、BORROWER、EMPLOYEE、BOOKS 四张表（含继承关系对应的联合表结构），同时建立外键约束（如 BOOKS.borrower_id → BORROWER.id）。

? 总结：Spring Boot 的“约定优于配置”极大提升了开发效率，但也要求开发者理解其默认扫描边界。当模块拆分较深（如分 model/controller/service/repository 包）时，主动使用 @EntityScan 和 @EnableJpaRepositories 是规范、安全且推荐的最佳实践。