Spring Boot JPA报错：Not a managed type，User实体未被JPA管理

问题场景 #

在Spring Boot项目中使用JPA操作数据库时，出现Bean创建失败错误，核心提示：

Not a managed type: class com.springboot.entities.User

尝试过@EnableJpaRepositories、@EntityScan注解仍未解决，项目代码及配置如下：

主应用类 #

package com.springboot;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ApplicationContext;
import com.springboot.dao.UserRepository;
import com.springboot.entities.User;

@SpringBootApplication
public class DataApplication {
    public static void main(String[] args) {
        ApplicationContext context = SpringApplication.run(DataApplication.class, args);
        UserRepository userRepository = context.getBean(UserRepository.class);
        User user = new User();
        user.setName("prashant");
        user.setCity("vikhroli");
        user.setStatus("java programming");
        User user2 = userRepository.save(user);
        System.out.println(user2);
    }
}

Repository类 #

@Repository
public interface UserRepository extends CrudRepository<User, Integer> {
}

Entity类 #

package com.springboot.entities;

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

@Entity
public class User
{
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    public int id;
    public String name;
    public String city;
    public String status;
    public User() {
        super();
    }
    public User(int id, String name, String city, String status) {
        super();
        this.id = id;
        this.name = name;
        this.city = city;
        this.status = status;
    }
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getCity() {
        return city;
    }
    public void setCity(String city) {
        this.city = city;
    }
    public String getStatus() {
        return status;
    }
    public void setStatus(String status) {
        this.status = status;
    }
    @Override
    public String toString() {
        return "User [id=" + id + ", name=" + name + ", city=" + city + ", status=" + status + "]";
    }
}

配置文件 #

spring.datasource.name=world
spring.datasource.url=jdbc:mysql://localhost:/pops
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
spring.jpa.hibernate.ddl-auto=update

完整错误日志 #

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'userRepository' defined in com.springboot.dao.UserRepository defined in @EnableJpaRepositories declared on JpaRepositoriesRegistrar.EnableJpaRepositoriesConfiguration: Not a managed type: class com.springboot.entities.User

核心原因及修复步骤 #

1. 注解包版本不匹配（最常见） #

Spring Boot 3.x及以上版本已切换到Jakarta EE规范，不再支持javax.persistence.*注解。如果项目使用Spring Boot 3+，需将实体类的注解替换为jakarta.persistence.*：

package com.springboot.entities;

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

@Entity
public class User {
    // 其余代码不变
}

2. 显式指定JPA扫描范围 #

若自动扫描机制失效，需在主应用类上明确指定Repository和实体类的扫描包：

package com.springboot;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ApplicationContext;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import com.springboot.dao.UserRepository;
import com.springboot.entities.User;

@SpringBootApplication
@EnableJpaRepositories(basePackages = "com.springboot.dao") // 指定Repository所在包
@EntityScan(basePackages = "com.springboot.entities") // 指定实体类所在包
public class DataApplication {
    // main方法不变
}

3. 移除Repository上多余的@Repository注解 #

JPA的Repository接口无需添加@Repository注解，Spring Data JPA会自动识别并创建代理Bean，移除后不影响功能：

// 去掉@Repository注解
public interface UserRepository extends CrudRepository<User, Integer> {
}

4. 修复数据库URL错误 #

配置文件中的数据库URL存在格式错误（localhost后多了斜杠，缺少端口），修正后避免后续数据库连接问题：

spring.datasource.url=jdbc:mysql://localhost:3306/pops?useSSL=false&serverTimezone=UTC

验证 #

完成上述修改后，重启项目，若控制台打印出保存的User对象，说明问题已解决。

内容的提问来源于stack exchange，提问作者Prashant Parapelli