Spring Boot JPA 实体扫描配置：解决数据库表未自动创建问题_技术教程

spring boot 启动时未创建 jpa 实体对应的数据库表，通常是因为实体类未被正确扫描到；默认仅扫描主启动类所在包及其子包，而本项目中 @entity 类位于独立的 model 包下，导致 hibernate 忽略建表逻辑。

在 Spring Boot + JPA 项目中，自动建表（如通过 spring.jpa.hibernate.ddl-auto=update）的前提是：所有 @Entity 类必须被 Spring Data JPA 成功加载和识别。而 Spring Boot 的默认行为是——仅自动扫描 @SpringBootApplication 注解所在类的包及其子包下的实体与仓库（Repository）。

你的项目结构如下：

主启动类 LibraryApplication 位于 projectlibrary.library 包；
所有实体（Book, Borrower, Employee, User）均定义在 model 包（与 projectlibrary.library 并列，非其子包）；
因此，JPA 启动时根本“看不到”这些实体，自然不会生成对应的数据表，日志中也通常不会报错（静默忽略），极易被忽视。

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

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

将 model 包移入 projectlibrary.library 下，例如改为 projectlibrary.library.model，并同步更新所有类的 package 声明。此时无需额外配置，Spring Boot 默认即可扫描到。

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

在 LibraryApplication 主类上添加 @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") // ← 关键：告诉 JPA 去 model 包找 @Entity
@EnableJpaRepositories(basePackages = "repository") // ← 若你有自定义 repository 接口，也需指定（如无，可暂不加）
public class LibraryApplication {
    public static void main(String[] args) {
        SpringApplication.run(LibraryApplication.class, args);
    }
}

? 验证提示：启动应用后，观察控制台日志。若配置生效，你会看到类似以下输出：HHH000397: Using ASTQueryTranslatorFactoryHHH000412: Hibernate ORM core version x.x.x.FinalHHH000262: Table not found: BOOKS → 随后应出现 create table BOOKS (...) 语句（取决于 ddl-auto 级别）。

⚠️ 补充关键注意事项

spring.jpa.hibernate.ddl-auto 的取值含义：
- update（当前配置）：仅增量更新表结构（新增字段/索引），不会删除旧列或重建表，适合开发；
- create-drop：每次启动建表、退出删表（仅测试用）；
- validate：只校验映射，不修改库；
- none：完全禁用 DDL 操作（生产环境推荐，配合 Flyway/Liquibase）。
外键与双向关联的完整性：
当前 Book 中 @ManyToOne 关联 Borrower，而 Borrower 中 @OneToMany(mappedBy="borrower") 已正确设置 mappedBy，这是合理的。但注意：Book.borrower 字段设为 nullable = false，意味着每本书必须有借阅人——若初始化时无数据，可能导致插入失败。建议首次启动使用 ddl-auto=create 或手动插入测试用户。
Lombok 与继承兼容性：
User 类使用了 @Getter@Setter@EqualsAndHashCode@ToString，而 Borrower/Employee 继承它。确保 Lombok 版本 ≥ 1.18.20，并在 User 上添加 @NoArgsConstructor（已存在）和 @AllArgsConstructor（已存在），避免子类构造器冲突。

✅ 最终检查清单

项目	是否完成
✅ @EntityScan(basePackages = "model") 已添加至主类	☐
✅ spring.datasource.* 配置正确，MySQL 服务运行且权限充足	☐
✅ 数据库 Library 已手动创建（或由 ddl-auto=create 自动创建）	☐
✅ 实体类无编译错误，jakarta.persistence.* 导包正确（非 javax.*）	☐