ServerBootstrap.group() 必须最先调用，否则 bind() 抛 IllegalStateException；正确顺序为 group()→channel()→其余配置，且 group() 需传入 boss 和 worker 两个 EventLoopGroup。
ServerBootstrap.group() 必须先调用，否则 bind() 会抛 IllegalStateException
Netty 的 ServerBootstrap 是典型的流式构建器，但顺序不是任意的。最常踩的坑是没调 group() 就直接 channel() 或 childHandler() —— 这时 bind() 执行时会报 java.lang.IllegalStateException: group not set，因为事件循环组（EventLoopGroup）是整个启动流程的调度基础。
正确顺序必须是：group() → channel() → 其余配置。其中 group() 要传两个参数：主 Reactor 组（处理 accept）和从 Reactor 组（处理 I/O），比如 new NioEventLoopGroup() 和 new NioEventLoopGroup()。
-
group()必须在所有其他方法前调用，且只能调一次 - 若只传一个
EventLoopGroup（如group(bossGroup)），Netty 会自动复用它作为 child 组，但生产环境不推荐——accept 和 I/O 负载特征不同，混用容易相互干扰 - 使用
EpollEventLoopGroup时，channel()必须对应为NioServerSocketChannel.class→ 错！应为EpollServerSocketChannel.class，否则运行时报ChannelException: failed to create a child event loop
childHandler() 里不能直接 new ChannelInitializer，得用匿名内部类或 lambda
childHandler() 接收的是 ChannelHandler，但你传进去的通常是负责初始化子 channel pipeline 的 ChannelInitializer。常见错误是写成 childHandler(new ChannelInitializer())，结果编译不过——因为 ChannelInitializer 是抽象类，不能直接实例化。
真正要传的是它的子类实例，最简写法是用匿名内部类或 lambda（Java 8+）：
childHandler(new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel ch) throws Exception {
ch.pipeline().addLast(new StringDecoder(), new MyBusinessHandler());
}
});
- lambda 写法更紧凑：
childHandler(ch -> ch.pipeline().addLast(new StringDecoder(), new MyBusinessHandler())) - 别在
initChannel()里做耗时操作（如 DB 查询、HTTP 同步调用），它运行在 I/O 线程上，会阻塞整个 event loop - 如果 handler 需要共享状态（如计数器），确保线程安全；Netty 不保证同一
ChannelInitializer实例只被调用一次
option() 和 childOption() 容易混淆，影响连接行为和子 channel 性能
option() 设置的是 ServerSocketChannel 自身的 TCP 层选项（如 SO_BACKLOG），而 childOption() 设置的是每个新建立的 SocketChannel 的选项（如 TCP_NODELAY、SO_KEEPALIVE）。搞反了就等于“给老板配工位，却去调员工电脑的 DPI”。
-
option(ChannelOption.SO_BACKLOG, 128)：控制 accept 队列长度，Linux 默认 128，高并发场景可适当调大（但受内核net.core.somaxconn限制） -
childOption(ChannelOption.TCP_NODELAY, true)：禁用 Nagle 算法，减少小包延迟，对 RPC/实时通信很关键 -
childOption(ChannelOption.SO_KEEPALIVE, true)：开启保活，但默认 2 小时才探测，实际业务需配合应用层心跳 - 某些 option 只对特定 channel 类型有效，比如
EpollChannelOption.SO_REUSEPORT仅在EpollServerSocketChannel下生效
bind() 返回 ChannelFuture，不能直接 get()，否则阻塞主线程
bind() 是异步操作，返回 ChannelFuture。新手常写 bootstrap.bind(port).get() 等待完成——这会让主线程卡住，失去非阻塞意义，还可能引发死锁（尤其在 EventLoop 线程里调用 get()）。
正确做法是注册监听器，在回调中处理成功或失败：
bootstrap.bind(8080).addListener((ChannelFutureListener) future -> {
if (future.isSuccess()) {
System.out.println("Server started on port 8080");
} else {
System.err.println("Start failed: " + future.cause());
future.channel().close();
}
});
- 不要在监听器里做重试逻辑（如失败后立刻再 bind），可能触发端口占用冲突；应加退避或交由外部控制
-
ChannelFuture.sync()是阻塞等待，仅适合测试或极简脚本，生产代码禁用 - 如果需要获取绑定后的
Channel实例，从future.channel()拿，而不是在bind()前就试图访问
