使用http4s服务端API时如何配置Tomcat

针对你提到的两个需求，目前都有对应的可行实现方式：

方案1：直接操作底层Tomcat实例 #

http4s的Tomcat服务端模块原生提供了Tomcat实例的修改入口，你可以通过modifyTomcat钩子拿到原生的org.apache.catalina.startup.Tomcat对象，配置所有Tomcat API支持的参数，无需依赖外置配置文件，这也是官方更推荐的类型安全配置方式，示例代码如下：

import org.http4s.tomcat.server.TomcatBuilder
import org.apache.catalina.startup.Tomcat
import cats.effect.IO

val server = TomcatBuilder[IO]
  .bindHttp(8080, "0.0.0.0")
  .withHttpApp(yourHttpApp)
  // 自定义Tomcat实例配置
  .modifyTomcat { tomcat: Tomcat =>
    // 调整连接器参数
    val connector = tomcat.getConnector
    connector.setProperty("maxThreads", "200")
    connector.setProperty("connectionTimeout", "30000")
    // 配置Host、Engine、Context等核心组件
    tomcat.getHost.setAutoDeploy(false)
    tomcat
  }
  .resource

// 启动服务
server.use(_ => IO.never).unsafeRunSync()

方案2：加载自定义server.xml配置 #

如果你有存量server.xml需要复用，可以通过Tomcat原生的配置加载接口先读取xml生成Tomcat实例，再传递给http4s的TomcatBuilder使用，示例代码如下：

import org.apache.catalina.startup.Catalina
import org.http4s.tomcat.server.TomcatBuilder
import cats.effect.IO
import java.io.File

// 加载自定义server.xml
val catalina = new Catalina()
catalina.setConfigFile(new File("./conf/server.xml").toURI.toURL)
catalina.load()

// 将加载好配置的Tomcat实例传入http4s builder
val server = TomcatBuilder[IO]
  .withTomcat(catalina.getTomcat)
  .withHttpApp(yourHttpApp)
  .resource

// 启动服务
server.use(_ => IO.never).unsafeRunSync()

注意该方式下，服务端口、上下文路径等配置优先以server.xml中的定义为准，需要避免和builder中配置的参数冲突。

额外说明 #

如果需要配置Servlet上下文相关的参数，也可以通过TomcatBuilder的withServletContextInitializer方法注入自定义初始化逻辑，适配更多场景。

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