You need to enable JavaScript to run this app. Spring Boot修改接口路径后新路径404旧路径仍生效问题排查
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot修改接口路径后新路径404旧路径仍生效问题排查

问题原因
  • 核心原因是@SpringBootApplication默认仅扫描启动类所在包及其子包下的组件(包含@RestController、@Service等注解的类),你调整文件结构移动TaskController后,控制器所在包不在默认扫描范围内,而你仅配置了@EntityScan和@EnableJpaRepositories的自定义扫描路径,没有补充配置控制器的组件扫描规则,导致Spring根本没有加载修改后的TaskController,还是在使用旧版本的控制器Bean,所以旧路径生效、新路径不生效。
  • 少数场景下也可能是IDE缓存未完全清理,导致运行的还是旧的编译产物。
解决方案
  1. 补充组件扫描配置(推荐)
    在启动类上添加@ComponentScan注解,指定整个项目的根包路径即可覆盖所有业务模块的扫描:
@SpringBootApplication
@ComponentScan(basePackages = "com.bl4kee.kanbanboard")
@EntityScan(basePackages = {"com.bl4kee.kanbanboard.entities.common","com.bl4kee.kanbanboard.entities.task"})
@EnableJpaRepositories(basePackages = {"com.bl4kee.kanbanboard.dao"})
public class KanbanBoardApplication {
    public static void main(String[] args) {
        SpringApplication.run(KanbanBoardApplication.class, args);
    }
}

如果控制器存放在单独的包路径下,也可以单独指定控制器的包路径,注意如果自定义@ComponentScan后默认扫描规则失效,需要把所有需要扫描的业务包都加入配置。

  1. 调整类位置(可选)
    将TaskController放到启动类所在包com.bl4kee.kanbanboard的子包下(比如com.bl4kee.kanbanboard.controller),即可被默认扫描规则识别,无需额外配置。

  2. 验证生效方式
    启动项目时查看控制台日志,搜索/tasks/id/{id}路径,确认该接口映射已被注册后再访问测试。如果还是存在问题,可执行maven的clean install命令后重启IDE,完全清除历史缓存。


内容的提问来源于stack exchange,提问作者Bl4kee

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 12:45:04