You need to enable JavaScript to run this app. Spring Boot自定义REST API调用返回404问题求助
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot自定义REST API调用返回404问题求助

404接口问题排查步骤

从你贴的错误响应中提取关键特征:返回的404响应中path字段值为/,和你实际请求的/api/project/v1/changes/raiseNewCR完全不一致,说明请求根本没有被路由到你编写的ChangeRequestController上,可按以下顺序定位问题:

  • 核查组件扫描范围
    Spring Boot默认仅扫描主启动类所在包及下属子包下的Bean。如果ChangeRequestController所在的包路径,不在主启动类的扫描层级内,控制器不会被注册为路由处理器,自然无法匹配到接口。
    验证方式:在测试类中尝试注入ChangeRequestController,如果抛出NoSuchBeanDefinitionException,即可确认是扫描范围的问题,可通过在主启动类上加@ComponentScan指定扫描范围解决。
  • 核查全局服务配置
    检查项目配置文件(application.properties/application.yml)中的两个核心配置:
    • server.port:确认实际启动端口确实是8082,避免端口被占用后启动了其他同应用实例
    • server.servlet.context-path:确认是否配置了全局路径前缀,如果配置了比如/web,实际访问地址需要拼接这个前缀;如果配置的context-path为/,当路径匹配失败时,Spring Boot默认返回的404响应就会在path字段显示根路径,和你当前的返回特征完全匹配。
  • 核查接口方法的请求匹配规则
    你当前方法上的@RequestMapping没有指定请求方法,默认兼容所有HTTP方法,可排除方法类型不匹配的问题,但需要额外检查:
    • 项目是否引入了Spring Security、权限拦截器这类组件,拦截规则是否把该POST请求拦截后重定向到了根路径
    • ChangeRequestDto类是否存在序列化/反序列化问题,导致请求参数解析失败被全局异常处理器接管
  • 核查启动阶段的路由注册日志
    Spring Boot启动过程中会打印所有注册成功的MVC路由,可在启动日志中搜索Mapped "{[/api/project/v1/changes/raiseNewCR]"关键字:
    • 搜索不到对应记录:说明控制器根本没完成注册,优先排查扫描范围问题
    • 能搜索到对应记录:说明是拦截层、路径前缀不匹配的问题

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.03 20:15:05