Spring Boot 3.1.2+Gradle+PostgreSQL建表无SQL无表生成问题

1. 检查JPA自动建表与SQL输出配置 #

默认情况下Spring Boot不会自动建表，需显式配置Hibernate的DDL策略，同时开启SQL日志输出。在application.properties中添加：

# 自动建表策略：update（保留现有数据）/create（每次重建）/create-drop（启动创建关闭删除），生产环境建议用none或validate
spring.jpa.hibernate.ddl-auto=update
# 开启SQL语句输出
spring.jpa.show-sql=true
# 格式化SQL日志，便于阅读
spring.jpa.properties.hibernate.format_sql=true

2. 验证实体类配置 #

• 实体类必须添加@Entity注解，且主键字段需用@Id+@GeneratedValue指定生成策略（适配PostgreSQL自增主键推荐用IDENTITY）：

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String username;
    private String email;

    // 必须提供无参构造方法（Hibernate要求），以及getter/setter
    public User() {}

    // 带参构造、getter/setter、toString方法
}

• 确认实体类所在包被Spring扫描：若实体类不在主启动类的子包下，需在主类添加@EntityScan(basePackages = "com.your.package.entity")指定扫描路径。

3. 确认数据源连接有效性 #

检查application.properties中的PostgreSQL配置是否正确，确保能正常连接数据库：

spring.datasource.url=jdbc:postgresql://localhost:5432/your_database_name
spring.datasource.username=your_db_user
spring.datasource.password=your_db_password
spring.datasource.driver-class-name=org.postgresql.Driver

可添加日志查看连接细节：

logging.level.com.zaxxer.hikari=DEBUG

启动后查看日志，若连接失败会有DEBUG级别的错误提示。

4. 检查Gradle依赖配置 #

确保引入Spring Data JPA和PostgreSQL驱动（Spring Boot 3.x使用Jakarta API，依赖版本由Spring Boot自动管理）：

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    runtimeOnly 'org.postgresql:postgresql'
    // 若需web模块可添加：implementation 'org.springframework.boot:spring-boot-starter-web'
}

执行gradle dependencies命令，确认依赖无冲突或缺失。

5. 触发Repository初始化 #

Spring Data JPA的Repository默认懒加载，若未被调用可能不会触发建表逻辑。可在主启动类添加CommandLineRunner主动触发：

import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;

@SpringBootApplication
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }

    @Bean
    CommandLineRunner init(UserRepository userRepository) {
        return args -> {
            // 执行简单查询触发Repository初始化
            userRepository.count();
        };
    }
}

内容的提问来源于stack exchange，提问作者Imen MK