Spring5 WebClient使用Reactor Netty时Transport的具体含义是什么

你在文档里看到的Transport和OSI模型的传输层概念无关，它指的是Netty对底层操作系统网络IO模型的封装实现——简单说就是Netty用来跟操作系统内核交互、完成网络数据收发的具体适配层，不同Transport对应不同操作系统的原生IO机制，支持的配置项、性能表现都有差异。

• NIO Transport
  这是Netty基于Java标准NIO API实现的通用传输层，全平台兼容（Windows、MacOS、Linux都能跑），是Reactor Netty默认使用的Transport。
  文档里标注它需要Java 11才能配置TCP_KEEPIDLE等参数，是因为这些细粒度TCP keepalive配置是Java 11才在ExtendedSocketOptions里新增的标准接口，低版本JDK的NIO没有暴露这些配置能力，自然无法设置。
• Epoll Transport
  这是Netty针对Linux系统开发的原生优化传输层，它直接调用Linux内核的Epoll边缘触发IO接口，绕开了JDK NIO的一层封装，高并发下性能比NIO Transport高30%左右，还支持很多Linux独有的TCP配置参数。你代码里用到的EpollChannelOption开头的配置项，只有启用Epoll Transport时才会生效。
  注意这个Transport只能在Linux环境使用，其他系统上运行会直接抛出加载异常。

你现在直接硬编码Epoll配置的写法有两个明显问题：

1. 本地开发如果用Windows/Mac系统，这些Epoll专属配置会直接失效，甚至报参数不识别的错误
2. 就算部署在Linux上，Reactor Netty默认不会自动开启Epoll Transport，你不手动启用的话，就算写了Epoll参数，实际运行时还是走NIO Transport，这些配置根本不会生效。

正确的兼容配置方式如下：
首先引入Linux原生Epoll依赖（Maven示例）：

<dependency>
    <groupId>io.netty</groupId>
    <artifactId>netty-transport-native-epoll</artifactId>
    <classifier>linux-x86_64</classifier>
</dependency>

初始化HttpClient时根据运行环境自动选择Transport和对应配置：

HttpClient httpClient;
if (Epoll.isAvailable()) {
    // Linux环境启用Epoll Transport
    httpClient = HttpClient.create()
            .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 5000)
            .option(ChannelOption.SO_KEEPALIVE, true)
            .option(EpollChannelOption.TCP_KEEPIDLE, 300)
            .option(EpollChannelOption.TCP_KEEPINTVL, 60)
            .option(EpollChannelOption.TCP_KEEPCNT, 8)
            .transport(TransportType.epoll)
            .doOnConnected(connection ->
                    connection.addHandlerLast(new ReadTimeoutHandler(1000, TimeUnit.SECONDS))
                            .addHandlerLast(new WriteTimeoutHandler(1000)));
} else {
    // 非Linux环境走NIO Transport，要求JDK版本 >=11
    httpClient = HttpClient.create()
            .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 5000)
            .option(ChannelOption.SO_KEEPALIVE, true)
            .option(NioChannelOption.of(ExtendedSocketOptions.TCP_KEEPIDLE), 300)
            .option(NioChannelOption.of(ExtendedSocketOptions.TCP_KEEPINTERVAL), 60)
            .option(NioChannelOption.of(ExtendedSocketOptions.TCP_KEEPCOUNT), 8)
            .transport(TransportType.nio)
            .doOnConnected(connection ->
                    connection.addHandlerLast(new ReadTimeoutHandler(1000, TimeUnit.SECONDS))
                            .addHandlerLast(new WriteTimeoutHandler(1000)));
}

// 后续构造WebClient的逻辑不变
WebClient webClient = WebClient.builder()
        .baseUrl("your target url")
        .defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
        .defaultHeader(HttpHeaders.ACCEPT, MediaType.APPLICATION_JSON_VALUE)
        .clientConnector(new ReactorClientHttpConnector(httpClient))
        .build();

生产环境如果是Linux部署，建议强制开启Epoll Transport，除了TCP配置支持更完整，高并发场景下的吞吐量、延迟表现都明显优于默认NIO Transport。

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