Spring Boot修改接口路径后新路径404旧路径仍生效问题排查
问题原因
- 核心原因是
@SpringBootApplication默认仅扫描启动类所在包及其子包下的组件(包含@RestController、@Service等注解的类),你调整文件结构移动TaskController后,控制器所在包不在默认扫描范围内,而你仅配置了@EntityScan和@EnableJpaRepositories的自定义扫描路径,没有补充配置控制器的组件扫描规则,导致Spring根本没有加载修改后的TaskController,还是在使用旧版本的控制器Bean,所以旧路径生效、新路径不生效。 - 少数场景下也可能是IDE缓存未完全清理,导致运行的还是旧的编译产物。
解决方案
- 补充组件扫描配置(推荐)
在启动类上添加@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后默认扫描规则失效,需要把所有需要扫描的业务包都加入配置。
调整类位置(可选)
将TaskController放到启动类所在包com.bl4kee.kanbanboard的子包下(比如com.bl4kee.kanbanboard.controller),即可被默认扫描规则识别,无需额外配置。验证生效方式
启动项目时查看控制台日志,搜索/tasks/id/{id}路径,确认该接口映射已被注册后再访问测试。如果还是存在问题,可执行maven的clean install命令后重启IDE,完全清除历史缓存。
内容的提问来源于stack exchange,提问作者Bl4kee
相关产品推荐
相关产品推荐

