如何为http4s客户端记录所有请求（v0.12.4版本）

当然没问题！在http4s v0.12.4版本里，你可以通过**客户端中间件（Client Middleware）**给你的SimpleHttp1Client加上请求日志功能，把所有请求详情写入文件。下面是两种实用的实现方案：

方案一：直接写入文件（快速实现） #

这种方式不需要额外依赖，直接用Java/Scala的IO API完成日志写入：

步骤1：定义日志写入工具函数 #

先写一个函数，把请求信息格式化后追加到日志文件里：

import org.http4s._
import java.io.{FileWriter, BufferedWriter}
import java.time.LocalDateTime

def logRequestToFile(request: Request): Unit = {
  // 格式化日志内容，包含时间、请求方法、URI和请求头
  val logEntry = s"[${LocalDateTime.now()}] ${request.method} ${request.uri} | Headers: ${request.headers}\n"
  
  // 以追加模式打开文件，写完后自动关闭
  val writer = new BufferedWriter(new FileWriter("http_requests.log", true))
  try {
    writer.write(logEntry)
  } finally {
    writer.close()
  }
}

步骤2：用中间件包装原客户端 #

把你的SimpleHttp1Client包装一下，让它在发起请求前先调用日志函数：

// 创建原始的SimpleHttp1Client
val originalClient: Client = org.http4s.client.blaze.SimpleHttp1Client()

// 创建带日志功能的客户端
val loggingClient: Client = Client { req =>
  // 先记录请求
  logRequestToFile(req)
  // 继续执行原始客户端的请求逻辑
  originalClient.run(req)
}

步骤3：使用带日志的客户端发起请求 #

之后用loggingClient代替原客户端即可，每次请求都会被记录到http_requests.log文件：

val aUri = Uri.uri("https://example.com")
loggingClient.fetch(Request(method = Method.GET, uri = aUri)) { response =>
  // 这里写你的响应处理逻辑，比如转成字符串
  response.as[String]
}

如果需要同时记录响应信息，也可以在获取响应后追加日志：

val loggingClientWithResponse: Client = Client { req =>
  logRequestToFile(req)
  originalClient.run(req).map { response =>
    // 记录响应状态和头信息
    val responseLog = s"[${LocalDateTime.now()}] Response for ${req.method} ${req.uri}: ${response.status} | Headers: ${response.headers}\n"
    val writer = new BufferedWriter(new FileWriter("http_requests.log", true))
    try {
      writer.write(responseLog)
    } finally {
      writer.close()
    }
    response
  }
}

方案二：用专业日志库（推荐） #

直接写文件的方式缺少日志滚动、异常处理等生产级特性，更推荐用SLF4J+Logback这类成熟的日志框架，把日志输出到文件：

步骤1：添加依赖（如果项目里还没加） #

在你的构建文件（比如sbt）里添加SLF4J和Logback的依赖：

libraryDependencies ++= Seq(
  "org.slf4j" % "slf4j-api" % "1.7.30",
  "ch.qos.logback" % "logback-classic" % "1.2.3"
)

步骤2：配置Logback输出到文件 #

在src/main/resources下创建logback.xml配置文件，指定日志输出到文件：

<configuration>
  <!-- 定义输出到文件的Appender -->
  <appender name="HTTP_REQUEST_FILE" class="ch.qos.logback.core.FileAppender">
    <file>http_requests.log</file>
    <!-- 日志格式：时间、线程、级别、日志器、消息 -->
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

  <!-- 给HTTP请求日志单独配置Logger -->
  <logger name="Http4sRequestLogger" level="INFO" additivity="false">
    <appender-ref ref="HTTP_REQUEST_FILE"/>
  </logger>
</configuration>

步骤3：实现日志中间件 #

用SLF4J的Logger来记录请求，替代直接写文件的逻辑：

import org.http4s._
import org.http4s.client.blaze.SimpleHttp1Client
import org.slf4j.LoggerFactory

// 获取自定义的Logger实例
val requestLogger = LoggerFactory.getLogger("Http4sRequestLogger")

// 创建带日志的客户端
val originalClient: Client = SimpleHttp1Client()
val loggingClient: Client = Client { req =>
  // 记录请求详情
  requestLogger.info(s"Outgoing Request: ${req.method} ${req.uri} | Headers: ${req.headers}")
  // 执行原始请求
  originalClient.run(req).map { response =>
    // 可选：记录响应信息
    requestLogger.info(s"Incoming Response: ${req.method} ${req.uri} | Status: ${response.status} | Headers: ${response.headers}")
    response
  }
}

步骤4：使用带日志的客户端 #

和方案一一样，用loggingClient发起请求即可，所有日志会自动输出到http_requests.log文件，Logback会帮你处理文件滚动、编码、异常等问题。

注意事项 #

• 如果你用的是异步客户端，要确保日志操作不会阻塞请求线程（方案二的日志库默认是异步的，更安全）
• 可以根据需求调整日志格式，比如添加请求体、响应体（注意敏感信息不要泄露）
• 对于大文件，方案二的Logback可以配置滚动策略（比如按大小、按时间分割日志）

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