Spring Boot接口/api/products无法映射，请求返回静态资源不存在

核心问题分析 #

启动日志明确显示JPA Repository接口未被Spring扫描到，这会引发连锁问题：

1. Repository实例无法被Spring容器管理，导致后续Controller的依赖注入失败（可能触发隐藏异常）
2. 若Controller因依赖问题未完成初始化，请求/api/products会被Spring MVC误判为静态资源请求，最终返回404并提示“静态资源不存在”

分步修复方案 #

1. 修正JPA Repository与实体类扫描配置 #

Spring Boot默认扫描主启动类所在包及其子包下的组件，若你的ProductRepository或Product实体类不在该层级内，需手动指定扫描路径：

方式一：主启动类添加扫描注解

@SpringBootApplication
@EnableJpaRepositories(basePackages = "com.yourproject.repository") // 替换为你的Repository实际包路径
@EntityScan(basePackages = "com.yourproject.entity") // 同步指定实体类所在包
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

方式二：调整包结构（更推荐）

将相关类移动到主启动类的子包下，保持规范的分层结构：

com.yourproject
├── YourApplication.java
├── entity
│   └── Product.java
├── repository
│   └── ProductRepository.java
└── controller
    └── ProductController.java

2. 验证Controller映射正确性 #

确保ProductController的注解配置无错误，避免请求路径不匹配：

@RestController
@RequestMapping("/api/products") // 确认根路径与请求一致
public class ProductController {

    private final ProductRepository productRepository;

    // 优先使用构造器注入
    public ProductController(ProductRepository productRepository) {
        this.productRepository = productRepository;
    }

    @GetMapping
    public List<Product> getAllProducts() {
        return productRepository.findAll();
    }
}

• 必须标注@RestController（而非@Controller，后者默认返回视图，易被误判为静态资源）
• 检查@GetMapping未额外添加子路径，确保GET /api/products能精准匹配到处理方法

3. 排查配置文件的静态资源路由冲突 #

若配置文件中错误将/api/**路径映射为静态资源，会直接导致请求被路由到静态资源处理器：

application.properties（示例）：

# 确保静态资源路径未覆盖/api前缀
spring.mvc.static-path-pattern=/static/**
spring.web.resources.static-locations=classpath:/static/

禁止设置spring.mvc.static-path-pattern=/api/**，这会将所有/api开头的请求当成静态资源处理。

4. 重启应用并验证 #

重启后检查启动日志，若出现类似以下内容，说明Repository已被成功扫描：

o.s.data.jpa.repository.support.JpaRepositoryFactoryBean : Initialized JpaRepository implementation for interface com.yourproject.repository.ProductRepository

此时再次发送GET /api/products请求，若所有配置正确，应返回预期数据而非404错误。

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