解决 Spring 中泛型服务类因多 Bean 冲突导致的启动失败问题-java教程-PHP中文网

解决 Spring 中泛型服务类因多 Bean 冲突导致的启动失败问题

Spring 启动时因泛型 ReadService 被误识别为需自动注入的组件，导致容器尝试为其 MAPPER 类型注入多个候选 Bean（如 ContinentMapperImpl 和 CountryMapperImpl），引发 “required a single bean, but 2 were found” 错误。根本原因在于错误地将泛型类标记为 @Service。

spring 启动时因泛型 `readservice` 被误识别为需自动注入的组件，导致容器尝试为其 `mapper` 类型注入多个候选 bean（如 `continentmapperimpl` 和 `countrymapperimpl`），引发 “required a single bean, but 2 were found” 错误。根本原因在于错误地将泛型类标记为 `@service`。

在 Spring 的依赖注入机制中，@Service、@Component 等 stereotype 注解会触发类路径扫描，并将标注类注册为 Spring Bean。但泛型类型参数（如 MAPPER）在运行时被擦除，Spring 无法区分不同泛型实参的 Bean 类型——它只看到原始类型 BaseMapperToDTO，而项目中恰好存在多个该类型的实现（ContinentMapperImpl、CountryMapperImpl），于是注入失败。

✅ 正确解法是：移除泛型服务类上的 @Service 注解，使其退化为普通工具类；改由具体业务服务（如 ContinentService）显式构造并持有其实例。这样既保留了泛型复用价值，又完全规避了 Spring 自动装配的歧义。

以下是重构后的标准实践：

✅ 正确结构示例

// 1. 移除 @Service —— ReadService 不再是 Spring Bean
@Transactional(readOnly = true)
@RequiredArgsConstructor
public class ReadService,
        REPOSITORY extends JpaRepository<entity id>> {

    private final MAPPER mapper;
    private final REPOSITORY repository;
    private final Class<entity> entityClass; // 推荐通过构造器传入，避免 @Setter + @PostConstruct

    public ENTITY findById(ID id) throws FunctionalException {
        return repository.findById(id)
                .orElseThrow(() -> new FunctionalException(
                        "No " + entityClass.getSimpleName() + " found with id: " + id));
    }

    public DTO findByIdToDto(ID id) throws FunctionalException {
        return mapper.toDto(findById(id));
    }

    public Collection<entity> findAll() {
        return repository.findAll();
    }

    public Collection<dto> findAllToDto() {
        return mapper.toDtos(findAll());
    }
}</dto></entity></entity></entity>

// 2. 具体业务服务作为 Spring Bean，负责构造泛型实例
@Service
@RequiredArgsConstructor
public class ContinentService {

    private final ReadService<integer continent continentdto continentmapper continentrepository> readService;

    // 构造器注入依赖，并直接初始化泛型服务
    public ContinentService(ContinentMapper mapper, ContinentRepository repo) {
        this.readService = new ReadService(mapper, repo, Continent.class);
    }

    public ContinentDto findByIdToDto(Integer id) throws FunctionalException {
        return readService.findByIdToDto(id);
    }

    public Collection<continentdto> findAllToDto() {
        return readService.findAllToDto();
    }
}</continentdto></integer>

// 3. Controller 仅依赖具体业务服务（无泛型暴露）
@RestController
@RequestMapping("/api/continent")
public class ContinentRestController {

    private final ContinentService continentService;

    public ContinentRestController(ContinentService continentService) {
        this.continentService = continentService;
    }

    @GetMapping("/{id}")
    public ContinentDto findById(@PathVariable Integer id) throws FunctionalException {
        return continentService.findByIdToDto(id);
    }

    @GetMapping
    public Collection<continentdto> findAll() {
        return continentService.findAllToDto();
    }
}</continentdto>