SpringBoot禁用JPA启动报错：At least one JPA metamodel must be present!

我完全能理解你的 frustration——明明你的REST服务只靠数据源直连数据库，根本没用到JPA，结果启动时被这个报错卡壳，而且试过常规方案还没解决，确实挺闹心的。结合你提到的已经查过案例、问过同事但无效的情况，咱们来深挖几个容易被忽略的排查点：

1. 排查间接引入的JPA依赖 #

很多时候你没直接加spring-boot-starter-data-jpa，但其他依赖可能偷偷把它带进来了。你可以用以下命令排查依赖树：

• Maven：mvn dependency:tree
• Gradle：./gradlew dependencies
  找到包含spring-boot-starter-data-jpa的依赖项，用排除规则把JPA模块去掉。比如Maven里这么写：

<dependency>
    <groupId>第三方依赖组ID</groupId>
    <artifactId>第三方依赖ID</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 彻底禁用JPA相关自动配置 #

只排除JpaRepositoriesAutoConfiguration可能不够，得把关联的自动配置类都排除掉。试试在启动类上这么写：

@SpringBootApplication(exclude = {
    JpaRepositoriesAutoConfiguration.class,
    HibernateJpaAutoConfiguration.class,
    // 如果你的数据源是手动配置的，也可以排除DataSourceAutoConfiguration，按需选择
    DataSourceAutoConfiguration.class
})
public class YourAppApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourAppApplication.class, args);
    }
}

或者在配置文件里全局排除：

# application.properties
spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.data.jpa.JpaRepositoriesAutoConfiguration,org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration

3. 检查代码中的JPA残留引用 #

因为是模板生成的项目，可能不小心混入了JPA相关的注解或类。全局搜索项目里的javax.persistence、org.springframework.data.jpa包，看看有没有意外引入的@Entity、Spring Data JPA的@Repository这些东西，把它们清理掉。

4. 清理模板生成的JPA配置项 #

模板可能自动生成了JPA相关的配置在application.properties或application.yml里，比如：

spring.jpa.hibernate.ddl-auto=none
spring.jpa.show-sql=true

这些配置会触发SpringBoot的JPA自动配置逻辑，把它们删掉或者注释掉试试。

5. 清空构建/IDE缓存 #

有时候缓存会导致依赖或配置没生效，试试：

• 清理IDE缓存（比如IntelliJ选File -> Invalidate Caches...，然后重启）
• Maven执行：mvn clean install
• Gradle执行：./gradlew clean build

如果以上方法都试过还是不行，建议你贴出依赖树的关键片段、启动类的完整注解、配置文件的核心内容，这样能更精准定位问题所在。

内容的提问来源于stack exchange，提问作者David M. Karr