从Akka Http迁移到Http4s：自定义指令的等效实现方案

Http4s 没有和 Akka Http 同名的 Directive 抽象，但提供了两类纯函数式的路由复用机制，完全可以覆盖自定义指令的所有使用场景，包括路径参数提取校验、请求头处理、通用鉴权、上下文注入这类通用逻辑封装，组合灵活度不弱于 Akka 指令。

路径参数类提取校验：自定义路径提取器+路由组合子 #

你示例中提取路径段UUID、校验格式失败返回400的场景，用Http4s dsl自带的路径提取器配合简单的路由封装就能实现，逻辑和你写的Akka自定义指令完全对齐：

import org.http4s._
import org.http4s.dsl.io._
import cats.effect.IO
import java.util.UUID
import scala.util.Try

trait CustomRouteExtractors {
  // 定义UUID格式路径段的提取器，自动完成格式校验
  object ValidUUID {
    def unapply(segment: String): Option[UUID] = Try(UUID.fromString(segment)).toOption
  }

  // 封装可直接复用的UUID路径匹配逻辑，等价于Akka的extractUUID指令
  def extractUUID(next: UUID => HttpRoutes[IO]): HttpRoutes[IO] = HttpRoutes.of[IO] {
    case req @ _ -> Root / ValidUUID(uuid) => next(uuid).run(req)
    case _ -> Root / invalidId => OptionT.liftF(BadRequest(s"Invalid uuid: $invalidId"))
  }
}

使用时直接嵌套复用即可，和Akka里调用自定义指令的体验一致：

// 路由使用示例
val apiRoutes: HttpRoutes[IO] = new CustomRouteExtractors {
  val routes = extractUUID { userId =>
    HttpRoutes.of[IO] {
      case GET -> Root / _ / "profile" => Ok(s"Fetch profile for user: $userId")
    }
  }
}.routes

如果是更简单的参数提取场景，甚至不用单独封装路由组合子，直接在路由里用自定义的ValidUUID提取器就行，代码更简洁。

跨路由通用逻辑：基于Kleisli的可复用路由wrapper #

对于请求头校验、鉴权、追踪ID注入这类跨多路由的通用逻辑——也就是你提到的处理请求头等场景，可以直接把逻辑封装成接收路由、返回新路由的wrapper函数，本质和Http4s中间件的实现逻辑一致，支持任意嵌套组合。
举个提取校验请求头TraceId的例子：

object CommonDirectives {
  import org.typelevel.ci._
  // 等价于Akka中提取X-Trace-Id的自定义指令，校验失败直接返回400
  def withTraceId(next: String => HttpRoutes[IO]): HttpRoutes[IO] = HttpRoutes.of[IO] { req =>
    req.headers.get(ci"X-Trace-Id").map(_.head.value) match {
      case Some(traceId) if traceId.nonEmpty => next(traceId).run(req)
      case _ => OptionT.liftF(BadRequest("Missing or invalid X-Trace-Id request header"))
    }
  }
}

这类wrapper可以和任意路由、其他自定义wrapper组合使用，和Akka指令的flatMap嵌套逻辑完全等价，而且因为是纯函数，类型推导和调试成本更低。

小提示：如果团队已经习惯Akka指令的书写风格，完全可以基于Http4s的路由类型自己实现一套和Akka API对齐的Directive抽象，核心逻辑不超过50行代码，迁移成本极低。

内容的提问来源于stack exchange，提问作者M.G.