使用HTTP4S+Jetty调用根路径时出现GET方法不支持的问题排查

这个错误的核心原因是你的UserSvcServlet没有正确对接HTTP4S的路由逻辑，Jetty虽然找到了这个Servlet，但它本身没有处理GET请求的逻辑，所以返回了"方法不支持"的错误。

问题出在哪？ #

你在web.xml里把UserSvcServlet映射到了/*，但如果这个Servlet是你自己实现的空类（或者没有继承HTTP4S的Servlet适配器），它就不会把Jetty的请求转发给你定义的UserSvcRoutes。Jetty的默认Servlet行为就是对未处理的请求返回405错误。

正确的解决步骤： #

1. 实现HTTP4S兼容的Servlet

你需要让UserSvcServlet继承HTTP4S提供的Http4sServlet，并把你的路由绑定到这个Servlet上。示例代码如下：

package io.databaker

import org.http4s.servlet.Http4sServlet
import org.http4s.HttpRoutes
import cats.effect.IO
// 导入你的HelloWorld服务和路由
import your.package.path.{HelloWorld, UserSvcRoutes}

class UserSvcServlet extends Http4sServlet[IO] {
  // 初始化你的HelloWorld服务实例（根据你的实际实现调整）
  private val helloWorldService: HelloWorld[IO] = HelloWorld.impl[IO]
  
  // 将HTTP4S路由绑定到Servlet的service方法
  override val service: HttpRoutes[IO] = UserSvcRoutes.helloWorldRoutes(helloWorldService)
}

2. 确认依赖已正确引入

确保你的项目依赖中包含了HTTP4S的Servlet模块（根据你使用的HTTP4S版本调整）：

// build.sbt中添加
libraryDependencies += "org.http4s" %% "http4s-servlet" % "0.23.20" // 替换为你的HTTP4S版本

3. 验证web.xml配置

你当前的web.xml配置是没问题的，只要Servlet实现正确，Jetty就能把请求转发给HTTP4S的路由处理：

<web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0">
  <servlet>
    <servlet-name>user-svc</servlet-name>
    <servlet-class>io.databaker.UserSvcServlet</servlet-class>
    <async-supported>true</async-supported>
  </servlet>
  <servlet-mapping>
    <servlet-name>user-svc</servlet-name>
    <url-pattern>/*</url-pattern>
  </servlet-mapping>
</web-app>

做完这些调整后，重启Jetty，再访问http://localhost:8080/就能看到预期的"Example"响应了。

内容的提问来源于stack exchange，提问作者softshipper