springboot启动报错:javax.servlet.ServletException: No adapter for handler

关注

原创最新推荐文章于 2026-07-16 14:36:11 发布 4.8k 阅读 AI 写同款· GEO 优化 ›

Spring WebSocket握手失败：No adapter for handler根因与修复 WebSocket握手本质上是携带Upgrade: websocket头的HTTP GET请求，需由专用HandlerAdapter处理；Spring MVC默认将所有路径交由DispatcherServlet分发，当其未被正确绕过时，会因无法识别WebSocket协议头而抛出'No adapter for handler'异常。该问题核心在于Servlet容器层的请求路由冲突，而非客户端或网络故障。技术价值体现在保障全双工通信基础链路畅通，广泛应用于实时聊天、协同编辑、消息推送等场景。本文聚焦Spring 阅读详情

javax.servlet.ServletException: No adapter for handler [com.springboot.wxauth.controller.AuthController@570792cf]: The DispatcherServlet configuration needs to include a HandlerAdapter that supports this handler
at org.springframework.web.servlet.DispatcherServlet.getHandlerAdapter(DispatcherServlet.java:1272) ~[spring-webmvc-5.1.3.RELEASE.jar:5.1.3.RELEASE]
at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1021) ~[spring-webmvc-5.1.3.RELEASE.jar:5.1.3.RELEASE]
at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:942) ~[spring-webmvc-5.1.3.RELEASE.jar:5.1.3.RELEASE]
at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1005) ~[spring-webmvc-5.1.3.RELEASE.jar:5.1.3.RELEASE]
at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:897) ~[spring-webmvc-5.1.3.RELEASE.jar:5.1.3.RELEASE]