Spring Boot泛型模式报错：BaseEntity非实体类问题排查求助

问题场景 #

使用Postman发送GET请求时返回500错误，错误信息如下：

"Not an entity: class com.example.serverside.models.baseEntity.BaseEntity; nested exception is java.lang.IllegalArgumentException: Not an entity: class com.example.serverside.models.baseEntity.BaseEntity"

问题根源 #

你在GenericRepository接口上添加了@Repository注解，Spring会自动尝试为这个泛型接口生成实现类，但此时Spring无法正确识别泛型参数的具体实体类型，会直接把BaseEntity当作实体类处理。而BaseEntity标注的是@MappedSuperclass，它本身不是JPA实体，因此触发了这个错误。

解决方法 #

1. 移除GenericRepository上的@Repository注解
   泛型父接口不需要添加@Repository，只需要让具体实体的Repository继承它即可。
2. 创建实体专属的Repository接口
   为Region创建单独的Repository接口，继承GenericRepository<Region>，并添加@Repository注解。
3. 修改Service层的依赖注入
   在RegionService中注入专属的RegionRepository，而非泛型的GenericRepository<Region>。

修改后的代码示例 #

GenericRepository（移除@Repository）

package com.example.serverside.repository;

import org.springframework.data.jpa.repository.JpaRepository;

import com.example.serverside.models.baseEntity.BaseEntity;

public interface GenericRepository<T extends BaseEntity> extends JpaRepository<T,Long> {
    
}

RegionRepository（新增）

package com.example.serverside.repository;

import org.springframework.stereotype.Repository;

import com.example.serverside.models.Region;

@Repository
public interface RegionRepository extends GenericRepository<Region> {
    
}

RegionService（修改注入）

package com.example.serverside.services;

import java.util.List;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import com.example.serverside.models.Region;
import com.example.serverside.repository.RegionRepository;

@Service
public class RegionService {

    private RegionRepository regionRepository;

    @Autowired
    public RegionService(RegionRepository regionRepository) {
        this.regionRepository = regionRepository;
    }
    
    public List<Region> findAll(){
        return regionRepository.findAll();
    }

}

这样修改后，Spring会正确识别Region是JPA实体，生成对应的Repository实现类，调用findAll方法时就不会再出现实体类型错误。

内容的提问来源于stack exchange，提问作者Randika Hasanudin