Netty无官方spring-boot-starter，生产环境应按需引入netty-transport、netty-buffer、netty-codec等核心模块，避免使用netty-all；需统一版本、区分NIO/Epoll、正确调用connect()并监听结果。
用 Maven 引入 Netty 依赖时，选哪个 starter？
Netty 没有官方 spring-boot-starter-netty，Spring Boot 默认用 Tomcat，想用 Netty 得手动配。直接依赖 io.netty:netty-all 看似省事，但会把所有模块（包括 netty-tcnative、netty-resolver-dns）全拉进来，增加 jar 包体积和类加载负担。
实操建议：
- 生产环境优先用
io.netty:netty-transport+io.netty:netty-buffer+io.netty:netty-codec，按需引入 - 如果要用 HTTPS，加
io.netty:netty-handler（含SslHandler） - IDEA 中右键项目 →
Maven→Reload，别只改 pom 就跑，否则EventLoopGroup可能报NoClassDefFoundError
启动时报错 java.lang.NoClassDefFoundError: io/netty/util/internal/PlatformDependent0
这是典型的依赖冲突或版本不匹配：Netty 4.1.x 要求 JDK 8+，但某些旧版 netty-common 和 netty-transport 版本号不一致，导致内部工具类找不到。
常见错误现象：
立即学习“Java免费学习笔记（深入）”；
- 明明写了
new NioEventLoopGroup()，却在 new 的那一行崩 - Maven 里声明了
4.1.95.Final，但某个 transitive dependency 拉了4.1.68.Final
实操建议：
- 在
pom.xml中用<dependencyManagement>统一锁定 Netty 所有子模块版本 - 运行
mvn dependency:tree -Dincludes=io.netty，检查是否有多个 Netty 版本共存 - 避免混用
netty-all和单模块依赖，二者不能共存
为什么 Bootstrap 配了 group(new NioEventLoopGroup()) 还连不上服务端？
Bootstrap 是客户端启动器，必须调用 connect() 才真正发起连接；只设 group、channel、handler 不会触发任何 IO。而且，connect() 是异步的，不等它完成就退出 main 线程，连接会被立即中断。
使用场景：
- 写测试时用
connect().sync()等待建立，但线上不要这么干 - 实际业务中要监听
ChannelFuture的addListener()，在operationComplete里处理成功或失败 - 别在
ChannelInitializer.initChannel()里做耗时操作（比如读配置文件），会阻塞 EventLoop
简短示例：
bootstrap.connect("localhost", 8080).addListener((ChannelFutureListener) future -> {
if (future.isSuccess()) {
System.out.println("Connected");
} else {
future.cause().printStackTrace();
}
});
用 NioEventLoopGroup 还是 EpollEventLoopGroup？
Linux 上用 EpollEventLoopGroup 性能更好（基于 epoll，无 select 轮询开销），但它不是跨平台的：Windows/macOS 下会抛 UnsatisfiedLinkError。而 NioEventLoopGroup 基于 JDK NIO，兼容性好但吞吐略低。
性能与兼容性影响：
- 高并发 Linux 服务器建议用
EpollEventLoopGroup，需额外引入netty-transport-native-epoll（注意 classifier 是linux-x86_64） - 开发机是 macOS，又不想改代码？可以用反射动态加载：
Class.forName("io.netty.channel.epoll.EpollEventLoopGroup")，捕获异常后 fallback 到 NIO - 别在同一个 JVM 里混用两种 group，EventLoop 分配策略不同，可能引发 channel 注册失败
容易被忽略的一点：即使用了 Epoll，如果 JDK 是 OpenJDK 17+ 且开启了 -XX:+UseZGC，某些低版本 Netty（如 4.1.90 之前）会因内存页对齐问题导致 DirectBuffer 分配失败——得升级到 4.1.95+ 或关 ZGC。
