Spring Boot JPA报错：创建userRepository Bean失败，User非托管类型

核心问题分析 #

出现该错误的核心原因包括：Spring Boot 3.x与JPA注解包不兼容、依赖冲突、代码冗余/语法错误导致JPA无法识别实体类。

解决步骤 #

1. 替换实体类的JPA注解包 #

Spring Boot 3.x基于Jakarta EE，需将实体类中的javax.persistence.*替换为jakarta.persistence.*，否则JPA无法识别实体注解。

修改后的User实体类：

package com.TVMovie.ReviewSystem.entity;

import java.util.HashSet;
import java.util.Set;
import jakarta.persistence.CascadeType;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import jakarta.persistence.OneToMany;
import jakarta.persistence.Table;
import lombok.Data;

@Data
@Entity
@Table(name = "user") // 可选：显式指定表名，避免与数据库关键字冲突
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String username;
    private String password;
    private String email;
    private String firstName;
    private String lastName;

    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL)
    private Set<Rating> ratings = new HashSet<>();

    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL)
    private Set<Review> reviews = new HashSet<>();

    // 保留空参和全参构造方法，Lombok的@Data已生成getter/setter，可删除手动编写的冗余方法
}

2. 清理pom.xml中的冲突/重复依赖 #

移除过时的javax依赖、重复的MySQL驱动，以及与Spring Boot父版本冲突的Hibernate依赖：

修改后的pom.xml：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.5</version>
        <relativePath/> <!-- 从仓库查找父项目 -->
    </parent>
    <groupId>com.TVMovie</groupId>
    <artifactId>ReviewSystem</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>Spring Boot演示项目</description>
    <properties>
        <java.version>17</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-rest</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-validation</artifactId>
        </dependency>
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.security</groupId>
            <artifactId>spring-security-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

3. 简化主类配置（可选） #

@SpringBootApplication默认扫描主类所在包及其子包，若实体类和Repository都在com.TVMovie.ReviewSystem的子包下，可省略@EntityScan和@EnableJpaRepositories的包路径配置：

package com.TVMovie.ReviewSystem;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

4. 移除Repository中的冗余方法 #

JpaRepository已内置save、findAll、count、delete等方法，无需重复定义，否则会导致方法冲突：

修改后的UserRepository：

package com.TVMovie.ReviewSystem.repository;

import java.util.List;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;
import com.TVMovie.ReviewSystem.entity.User;

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    User findByUsername(String username);
    User findByEmail(String email);
    List<User> findByFirstName(String firstName);
    List<User> findByLastName(String lastName);

    @Query("SELECT u FROM User u LEFT JOIN FETCH u.ratings")
    List<User> findAllWithRatings();

    @Query(value = "SELECT * FROM user WHERE username LIKE %:search%", nativeQuery = true)
    List<User> searchUsersByUsername(@Param("search") String search);

    User findByUsernameAndPassword(String username, String password);
}

5. 修复UserService接口的语法错误 #

接口中findAllWithRatings方法缺少括号，需补充：

package com.TVMovie.ReviewSystem.service;

import java.util.List;
import java.util.Optional;
import com.TVMovie.ReviewSystem.entity.Rating;
import com.TVMovie.ReviewSystem.entity.Review;
import com.TVMovie.ReviewSystem.entity.User;

public interface UserService {
    // 创建（保存）用户
    User save(User user);
    // 查询所有用户
    List<User> findAll();
    Optional<User> findById(Long id);
    // 统计用户数量
    long count();
    // 删除用户
    void delete(User user);
    // 根据用户名查询用户
    User findByUsername(String username);
    // 根据邮箱查询用户
    User findByEmail(String email);
    // 根据名字查询用户
    List<User> findByFirstName(String firstName);
    // 根据姓氏查询用户
    List<User> findByLastName(String lastName);
    // 查询所有带评分的用户
    List<User> findAllWithRatings(); // 补充括号
    // 根据用户名搜索用户
    List<User> searchUsersByUsername(String search);
    // 用户身份验证
    Optional<User> authenticateUser(String username, String password);
    // 为用户添加评分
    Rating addRatingToUser(User user, Rating rating);
    // 移除用户评分
    void removeRatingFromUser(User user, Rating rating);
    // 为用户添加评论
    Review addReviewToUser(User user, Review review);
    // 移除用户评论
    void removeReviewFromUser(User user, Review review);
}

内容的提问来源于stack exchange，提问作者Amal Sai