Spring Boot报错：Not a managed type: com.smart.entities.User

我是Spring Boot新手，使用自定义的UserRepository时遇到以下错误：

Caused by: java.lang.IllegalArgumentException: Not a managed type: class com.smart.entities.User

已经试过ComponentScan、@EnableJpaRepositories这类常见解决方案，但都没用，以下是相关代码：

控制器代码 #

package com.smart.controller;

@Controller
public class HomeController {

    @Autowired
    private UserRepository userRepository;

    // handler for registering user
    @RequestMapping(value = "/do_register", method = RequestMethod.POST)
    public String registerUser(@ModelAttribute("user") User user,
            @RequestParam(value = "agreement", defaultValue = "false") boolean agreement, Model model,
            HttpSession session) {
        try {
            if (!agreement) {
                throw new Exception("You have not agreed terms and conditions");
            }

            user.setRole("ROLE_USER");
            user.setEnabled(true);
            user.setImageUrl("default.png");

            this.userRepository.save(user);

            model.addAttribute("user", new User());
            session.setAttribute("message", new Message("Successfully Registered!! ", "alert - success"));

            System.out.println("Agreement " + agreement);
            System.out.println("User " + user);
            return "signup";
            
        } catch (Exception e) {
            e.printStackTrace();
            model.addAttribute("user", user);
            session.setAttribute("message", new Message("SomeThing went wrong " + e.getMessage(), "alert - danger"));
            return "signup";
        }

    }

}

Repository代码 #

package com.smart.dao;

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

}

User实体类代码 #

package com.smart.entities;

@Entity
@Table(name="USER")
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private int id;
    private String name;

    @Column(unique = true)
    private String email;
    private String password;
    private String role;
    private Boolean enabled;
    private String imageUrl;
    
    @Column(length = 500)
    private String about;
    
    @OneToMany(cascade = CascadeType.ALL, fetch = FetchType.LAZY, mappedBy = "user")
    private List<Contact> contacts = new ArrayList<>();
    
    public List<Contact> getContacts() {
        return contacts;
    }

    public void setContacts(List<Contact> contacts) {
        this.contacts = contacts;
    }

    public User() {
        super();
        
    }

    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 getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public String getRole() {
        return role;
    }

    public void setRole(String role) {
        this.role = role;
    }

    public Boolean getEnabled() {
        return enabled;
    }

    public void setEnabled(Boolean enabled) {
        this.enabled = enabled;
    }

    public String getImageUrl() {
        return imageUrl;
    }

    public void setImageUrl(String imageUrl) {
        this.imageUrl = imageUrl;
    }

    public String getAbout() {
        return about;
    }

    public void setAbout(String about) {
        this.about = about;
    }
    
}

解决办法 #

1. 明确指定扫描范围 #

Spring Boot默认只扫描主启动类所在包及其子包。如果你的主启动类不在com.smart根包下，或者实体/Repository包不在主启动类的子包中，必须显式指定扫描路径：
在主启动类上添加：

@SpringBootApplication
@EntityScan(basePackages = "com.smart.entities") // 指定实体类所在包
@EnableJpaRepositories(basePackages = "com.smart.dao") // 指定Repository所在包
@ComponentScan(basePackages = "com.smart") // 扫描所有组件包
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 检查注解依赖包 #

确认实体类的@Entity、@Id等注解来自正确的包：

• Spring Boot 2.x 使用 javax.persistence.*
• Spring Boot 3.x 使用 jakarta.persistence.*
  如果导入了错误的包，JPA无法将User识别为托管实体。

3. 验证依赖完整性 #

确保项目依赖中包含Spring Data JPA和对应数据库驱动：
Maven示例（pom.xml）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<!-- MySQL驱动（根据你的数据库调整） -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
</dependency>

4. 清理缓存并重新构建 #

执行以下操作清除IDE和构建工具缓存：

• Maven：mvn clean install
• Gradle：gradle clean build
  然后重启IDE，重新运行项目。

内容的提问来源于stack exchange，提问作者Kavita Sanap