You need to enable JavaScript to run this app. JSP项目Swagger接口请求找不到响应部分报404错误如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

JSP项目Swagger接口请求找不到响应部分报404错误如何解决?

排查步骤
  • 首先确认请求地址是否正确:打开浏览器F12网络面板,复制Swagger发起请求的完整URL,手动用API调试工具(Postman、Apifox等)访问该地址,确认是否可以正常响应。
    • 如果手动访问也返回404,说明接口本身没有正确注册到服务路由中,继续排查后端配置
    • 如果手动访问正常,说明Swagger配置的请求地址规则有误,优先检查Swagger的路径相关配置
  • 检查JAX-RS资源注册配置:你使用的是JAX-RS规范(Jersey/RESTEasy等实现),当前接口类仅加了@Service和@Api注解,没有加类级别的@Path注解,也需要确认该类是否被注册到JAX-RS的资源扫描规则中,没有被扫描到的资源类接口访问会直接返回404。
  • 移除GET请求多余的@Consumes注解:GET请求没有请求体,不需要指定接收的媒体类型,该注解可能导致路由规则匹配失败,触发404。
  • 检查Swagger的根路径配置:确认Swagger配置的basePath(OpenAPI 2.0)或servers(OpenAPI 3.x)字段是否和服务实际的上下文路径、端口、域名一致。比如服务实际运行在http://localhost:8080/demo/,但Swagger配置的根路径为空,就会导致请求缺少/demo前缀,触发404。
  • 检查服务的权限拦截规则:确认是否有全局拦截器、鉴权过滤器在请求到达接口前就拦截了请求,直接返回了404错误。
  • 检查查询参数名的合法性:当前@QueryParam注解中的参数名带有空格(如Client ID、Redirect Uri),虽然该问题不会直接触发404,但会导致参数解析失败,建议将参数名改为不带空格的标准命名(如clientId、redirectUri)。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.13 12:24:01