Netty写服务器和客户端的核心答案:服务端用ServerBootstrap绑定端口,客户端用Bootstrap发起连接,二者共用ChannelPipeline装配编解码和业务Handler,最后用ChannelFuture和shutdownGracefully管住生命周期。 这件事没有想象中玄乎,先把线程模型和协议边界定清楚,代码反而很直白。
先理清Netty服务端和客户端有什么区别
很多初学者一上来就复制两段示例,结果服务端能启动、客户端连不上,问题往往出在启动类和Handler装配方式混用了,行业共识认为,先分清ServerBootstrap和Bootstrap的职责,比背API更重要。
| 对比项 | 服务端 | 客户端 |
|---|---|---|
| 启动类 | ServerBootstrap | Bootstrap |
| 线程组 | bossGroup负责accept,workerGroup负责I/O读写 | 一个EventLoopGroup处理连接和读写 |
| Channel类型 | NioServerSocketChannel | NioSocketChannel |
| Handler装配 | childHandler | handler |
| 启动动作 | bind(port) | connect(host, port) |
线程模型怎么配才不浪费
- 服务端通常建两个EventLoopGroup:bossGroup只负责接收连接,workerGroup负责已建立连接的读写。
- bossGroup线程数给1就够,除非你有多个监听端口;workerGroup默认跟随CPU核数,Netty源码默认值通常是CPU核数的两倍,以实际版本为准。
- 客户端只建一个EventLoopGroup,连接数少时不必照搬服务端的两组线程。
- 业务里不要做阻塞调用,数据库查询、文件读写、远程HTTP请求要丢到独立业务线程池,否则会把EventLoop卡住。
依赖和启动入口怎么落
Maven项目里加入netty-all,版本用属性锁定到4.1.x的最新稳定版,2026年仍建议优先跟随4.1长期维护线,升级前看官方release notes。
<dependency>
<groupId>io.netty</groupId>
<artifactId>netty-all</artifactId>
<version>${netty.version}</version>
</dependency>
服务端启动骨架可以这样写:
EventLoopGroup boss = new NioEventLoopGroup(1);
EventLoopGroup worker = new NioEventLoopGroup();
try {
ServerBootstrap b = new ServerBootstrap();
b.group(boss, worker)
.channel(NioServerSocketChannel.class)
.childOption(ChannelOption.SO_KEEPALIVE, true)
.childOption(ChannelOption.TCP_NODELAY, true)
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override protected void initChannel(SocketChannel ch) {
ch.pipeline()
.addLast(new LineBasedFrameDecoder(1024))
.addLast(new StringDecoder(CharsetUtil.UTF_8))
.addLast(new StringEncoder(CharsetUtil.UTF_8))
.addLast(new SimpleChannelInboundHandler<String>() {
@Override protected void channelRead0(ChannelHandlerContext ctx, String msg) {
ctx.writeAndFlush("echo:" + msg + "\n");
}
});
}
});
ChannelFuture f = b.bind(8080).sync();
f.channel().closeFuture().sync();
} finally {
boss.shutdownGracefully();
worker.shutdownGracefully();
}
客户端把启动类换成Bootstrap,Channel换成NioSocketChannel,Handler方法用handler(),最后connect("127.0.0.1", 8080).sync()拿到Channel再写数据,两边的编解码器要一致,这是通信能不能通的第一道门槛。
Netty服务器和客户端怎么通信:从编解码到心跳
Netty底层传的是ByteBuf,业务看到的字符串、JSON、Protobuf都需要编解码器转换,通信出问题,先看Pipeline顺序,再看协议是否对称。
服务端Handler怎么写
- 入站解码在前,业务处理在后:
LineBasedFrameDecoder、StringDecoder、业务Handler依次添加。 - 出站编码器要放在业务Handler之前或之后都可以,但顺序要和入站逻辑对齐,避免“能收不能发”。
- 继承
SimpleChannelInboundHandler时,消息处理完会自动释放ByteBuf;如果继承ChannelInboundHandlerAdapter,就要自己判断引用计数并释放。 - 返回响应统一用
ctx.writeAndFlush(),不要直接操作底层Channel,除非你明确知道线程上下文。
客户端怎么发请求和收响应
Bootstrap b = new Bootstrap();
b.group(group)
.channel(NioSocketChannel.class)
.option(ChannelOption.TCP_NODELAY, true)
.handler(new ChannelInitializer<SocketChannel>() {
@Override protected void initChannel(SocketChannel ch) {
ch.pipeline()
.addLast(new LineBasedFrameDecoder(1024))
.addLast(new StringDecoder(CharsetUtil.UTF_8))
.addLast(new StringEncoder(CharsetUtil.UTF_8))
.addLast(new SimpleChannelInboundHandler<String>() {
@Override protected void channelRead0(ChannelHandlerContext ctx, String msg) {
System.out.println("recv: " + msg);
}
});
}
});
Channel ch = b.connect("127.0.0.1", 8080).sync().channel();
ch.writeAndFlush("hello netty\n");
ch.closeFuture().sync();
这段代码里有两个关键点:connect之后要sync拿到可写Channel,要符合换行协议,很多“服务端收不到”的问题,就是客户端发了数据但没带分隔符,LineBasedFrameDecoder一直在等。
粘包半包和心跳怎么处理
- 文本协议用
LineBasedFrameDecoder或DelimiterBasedFrameDecoder,二进制协议用LengthFieldBasedFrameDecoder,长度字段偏移量和长度要和服务端约定死。 - 心跳用
IdleStateHandler,读空闲、写空闲、读写空闲分别设阈值,触发后由自定义Handler发心跳或关连接。 - 客户端断线重连不要写在
channelInactive里直接死循环,用定时任务加退避重试更稳。
物联网场景下Netty服务端怎么写
设备长连接和普通Web请求不是一回事,设备可能弱网、频繁重连、协议版本不一致,服务端要把鉴权、心跳、业务处理拆开,业内专家指出,物联网网关的稳定性和Handler拆分粒度关系很大。
设备接入的启动配置
SO_BACKLOG按并发连接量调大,避免accept队列溢出。SO_KEEPALIVE打开,配合应用层心跳,别只靠TCP保活。TCP_NODELAY打开,小包指令场景下减少延迟。- 给每个连接分配唯一
ChannelId,用ChannelGroup管理在线设备,下线时统一清理。
Pipeline拆分顺序
- 帧解码器。
- 协议解码器。
- 鉴权Handler:读取首帧设备编号和token,校验通过后从Pipeline移除自己。
- 心跳Handler:处理IdleStateEvent。
- 业务Handler:按消息类型分发,不在这里做耗时入库。
有些团队在立项时会搜“Netty服务器开发培训价格”,但基础长连接服务更该先把线程模型和编解码跑通,培训预算可以后置;在深圳Netty服务器开发项目里,常见做法也是先用官方example搭骨架,再补协议、监控和压测。
优雅下线怎么做
服务端关闭时先停止接收新连接,再关闭ChannelGroup里的活跃连接,最后调用shutdownGracefully(),客户端退出前writeAndFlush后等一小段时间再关Channel,避免最后一条消息丢在发送缓冲区。
完整实操:从编译到验证
- 编译:
mvn -q -DskipTests package。 - 启动服务端:
java -jar target/netty-demo.jar server。 - 启动客户端:
java -jar target/netty-demo.jar client。 - 看端口:
ss -lntp | grep 8080,Linux下能确认监听是否成功。 - 看线程:
jstack <pid>,重点看EventLoop线程有没有被业务阻塞。 - 压测前先用
telnet 127.0.0.1 8080或nc发一条带换行的文本,确认基础链路通。
常见坑集中在三处:bind后没sync就发请求、Handler加了@Sharable却被多连接复用状态、ByteBuf没释放导致内存上涨,排查时先看Pipeline顺序,再看引用计数,最后看业务线程池。
Netty写服务器和客户端,本质是把“连接管理、协议编解码、业务处理”三层拆开,把ServerBootstrap和Bootstrap的差异记牢,把Pipeline顺序配对,剩下的就是按业务补心跳、重连和监控。
Netty服务器和客户端常见问题Q&A
Q1:Netty服务端和客户端可以共用一个EventLoopGroup吗?
可以,小工具或测试代码里常这么写,生产服务端建议boss和worker分开,客户端单独建组,避免accept和业务读写互相影响。
Q2:Netty服务器和客户端怎么通信时总出现粘包?
先确认双方是否使用同一种帧解码器,文本协议用换行分隔,二进制协议用长度字段分隔;只加StringDecoder不加帧解码器,粘包半包问题仍然存在。
Q3:物联网场景下Netty服务端怎么写鉴权?
鉴权Handler放在Pipeline首位,读取首帧设备编号和token,校验通过后调用ctx.pipeline().remove(this),后续业务Handler才处理数据。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/801365.html


