Spring Boot启动报错：无法找到LocationRepository类型的Bean

问题背景 #

首次使用Spring Boot开发游戏相关REST应用，启动时提示无法找到LocationRepository类型的Bean，移除相关Repository后又会提示找不到QuestRepository，尝试多种方案无效。

应用包结构 #

com.findersgame.questtracker
|- FindersGameQuestTrackerApiApplication.java
|
|- controller
|  |- QuestController.java
|
|- model
|  |- Location.java
|  |- Provider.java
|  |- Quest.java
|
|- repository
|  |- LocationRepository.java
|  |- ProviderRepository.java
|  |- QuestRepository.java
|
|- service
   |- QuestService.java

核心代码 #

主启动类 #

package com.findersgame.questtracker;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication(scanBasePackages={ "com.findersgame.questtracker.*" })
@EnableJpaRepositories("com.findersgame.questtracker.repository.*")
@ComponentScan(basePackages = { "com.findersgame.questtracker.*" })
public class FindersGameQuestTrackerApiApplication {

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

Controller类 #

package com.findersgame.questtracker.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import com.findersgame.questtracker.service.QuestService;

@RestController
public class QuestController {
    private QuestService questService;

    public QuestController(QuestService questService) {
        super();
        this.questService = questService;
    }
    
    @GetMapping("fix-quests")
    public void fixQuests() {
        questService.fixQuests();
    }
}

Service类 #

package com.findersgame.questtracker.service;

import java.util.List;

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

import com.findersgame.questtracker.model.Location;
import com.findersgame.questtracker.model.Provider;
import com.findersgame.questtracker.model.Quest;
import com.findersgame.questtracker.repository.LocationRepository;
import com.findersgame.questtracker.repository.ProviderRepository;
import com.findersgame.questtracker.repository.QuestRepository;

@Service
public class QuestService {
    
    @Autowired
    private LocationRepository locationRepository;
    
    @Autowired
    private ProviderRepository providerRepository;
    
    @Autowired
    private QuestRepository questRepository;
    
    @Autowired
    public QuestServiceImpl(
            FlooRepository flooRepository,
            GiverRepository giverRepository,
            QuestRepository questRepository) {

        super();
        this.flooRepository = flooRepository;
        this.giverRepository = giverRepository;
        this.questRepository = questRepository;
    }

    public void fixQuests() {
        List<Quest> quests = questRepository.findAll();
        
        quests.forEach(quest -> {
            String locationName = quest.getLocationName();
            String providerName = quest.getProviderName();
            
            if (locationName != null) {
                Location location = locationRepository.findByName(locationName);
                
                if (location != null) {
                    quest.setLocationId(location.getId());
                }
            }
            
            if (providerName != null) {
                Provider provider = providerRepository.findByName(providerName);
                
                if (provider != null) {
                    quest.setLocationId(provider.getId());
                }
            }
            
            questRepository.save(quest);
        });
    }
}

Repository类 #

LocationRepository

package com.findersgame.questtracker.repository;

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;

import com.findersgame.questtracker.model.Location;

@Repository
public interface LocationRepository extends JpaRepository<Location, Long> {
    @Query(value = "SELECT * FROM locations WHERE `name` = ?1", nativeQuery = true)
    Location findByName(String name);
}

ProviderRepository

package com.findersgame.questtracker.repository;

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;

import com.findersgame.questtracker.model.Provider;

@Repository
public interface ProviderRepository extends JpaRepository<Provider, Long> {
    @Query(value = "SELECT * FROM providers WHERE `name` = ?1", nativeQuery = true)
    Provider findByName(String name);
}

QuestRepository

package com.findersgame.questtracker.repository;

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

import com.findersgame.questtracker.model.Quest;

@Repository
public interface QuestRepository extends JpaRepository<Quest, Long> {
    //pass
}

模型类说明 #

• Quest包含id、locationId、locationName、providerId、providerName和name字段
• Location和Provider仅包含id和name字段
• 所有模型类均已实现getter和setter方法

报错信息 #

***************************
APPLICATION FAILED TO START
***************************

Description:

Parameter 0 of constructor in com.findersgame.questtracker.service.QuestService required a bean of type 'com.findersgame.questtracker.repository.LocationRepository' that could not be found.


Action:

Consider defining a bean of type 'com.findersgame.questtracker.repository.LocationRepository' in your configuration.

已尝试的解决方案 #

• 为主类添加@EnableJpaRepositories注解
• 为主类添加@ComponentScan注解
• 为service添加@Service注解、为repository添加@Repository注解（也尝试过不加@Repository）
• 尝试为属性和构造函数添加/移除@Autowired注解
• 移除LocationRepository和ProviderRepository后，报错变为无法找到QuestRepository

解决方案 #

1. 修复Service类的构造函数错误 #

你的QuestService类存在明显错误：

• 构造函数名为QuestServiceImpl，但类名是QuestService，构造函数名必须与类名完全一致
• 构造函数中引用了不存在的FlooRepository和GiverRepository，应替换为实际的LocationRepository和ProviderRepository
• 混用字段注入和构造函数注入，建议统一使用构造函数注入（符合Spring最佳实践）

修正后的QuestService：

package com.findersgame.questtracker.service;

import java.util.List;

import org.springframework.stereotype.Service;

import com.findersgame.questtracker.model.Location;
import com.findersgame.questtracker.model.Provider;
import com.findersgame.questtracker.model.Quest;
import com.findersgame.questtracker.repository.LocationRepository;
import com.findersgame.questtracker.repository.ProviderRepository;
import com.findersgame.questtracker.repository.QuestRepository;

@Service
public class QuestService {
    
    private final LocationRepository locationRepository;
    private final ProviderRepository providerRepository;
    private final QuestRepository questRepository;
    
    // Spring 4.3+支持构造函数注入无需@Autowired
    public QuestService(
            LocationRepository locationRepository,
            ProviderRepository providerRepository,
            QuestRepository questRepository) {
        this.locationRepository = locationRepository;
        this.providerRepository = providerRepository;
        this.questRepository = questRepository;
    }

    public void fixQuests() {
        List<Quest> quests = questRepository.findAll();
        
        quests.forEach(quest -> {
            String locationName = quest.getLocationName();
            String providerName = quest.getProviderName();
            
            if (locationName != null) {
                Location location = locationRepository.findByName(locationName);
                
                if (location != null) {
                    quest.setLocationId(location.getId());
                }
            }
            
            if (providerName != null) {
                Provider provider = providerRepository.findByName(providerName);
                
                if (provider != null) {
                    // 修正：之前错误将providerId赋值给locationId，改为setProviderId
                    quest.setProviderId(provider.getId());
                }
            }
            
            questRepository.save(quest);
        });
    }
}

2. 简化主启动类注解 #

@SpringBootApplication已包含@ComponentScan、@Configuration和@EnableAutoConfiguration，无需额外添加@ComponentScan；@EnableJpaRepositories默认扫描主类所在包及其子包，可简化配置：

package com.findersgame.questtracker;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication
@EnableJpaRepositories(basePackages = "com.findersgame.questtracker.repository")
public class FindersGameQuestTrackerApiApplication {

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

若Repository都在主类的子包下，甚至可省略@EnableJpaRepositories，Spring Boot会自动扫描识别。

3. 补充模型类的JPA注解 #

确保模型类添加@Entity、@Id等JPA注解，比如Location类：

package com.findersgame.questtracker.model;

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

@Entity
@Table(name = "locations")
public class Location {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    
    // getter和setter方法
}

Provider和Quest类也需要类似注解，否则JPA无法识别实体，导致Repository无法被正确创建为Bean。

总结 #

核心问题是QuestService的构造函数存在命名错误和引用不存在的Repository类，导致Spring无法完成依赖注入。同时建议遵循Spring最佳实践，使用构造函数注入、简化主启动类注解，并确保模型类配置正确的JPA注解。

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