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
相关产品推荐
相关产品推荐

