1. 项目概述
最近在做一个需要实时通信功能的项目，决定采用Spring Boot + Netty的方案来构建WebSocket服务。Netty作为高性能的网络通信框架，非常适合处理大量并发连接和实时数据传输的场景。下面我会详细记录从零开始搭建这个聊天服务的过程，包括环境配置、核心代码实现和调试技巧。
2. 环境准备与项目创建
2.1 初始化Spring Boot项目
在IntelliJ IDEA中创建新项目，选择Spring Initializr：
- Language: Java
- Type: Maven
- Java版本: 8
- Spring Boot版本: 2.7.6
选择2.7.6版本是因为它在稳定性和功能支持上达到了很好的平衡，同时与Netty 4.1.68.Final版本兼容性良好。
2.2 Maven配置优化
2.2.1 阿里云镜像配置
在settings.xml中添加阿里云镜像，可以显著加快依赖下载速度：
xml复制<mirrors>
<mirror>
<id>alimaven</id>
<mirrorOf>central</mirrorOf>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
</mirror>
</mirrors>
2.2.2 本地仓库管理
建议为不同项目创建独立的本地仓库目录，避免所有项目共用默认的.m2仓库。我在项目根目录下创建了res文件夹作为本地仓库：
code复制项目结构：
- project-root/
- res/ (本地仓库)
- src/
- pom.xml
2.3 项目结构配置
在Project Structure中检查以下配置：
- Project SDK: Java 1.8
- Language level: 8
- 确保Maven配置指向正确的settings.xml和本地仓库路径
3. 核心依赖配置
在pom.xml中添加必要的依赖：
xml复制<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>io.netty</groupId>
<artifactId>netty-all</artifactId>
<version>4.1.68.Final</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
</dependencies>
选择Netty 4.1.68.Final版本是因为它稳定且功能完善，同时与Spring Boot 2.7.6兼容性良好。
4. Netty服务器实现
4.1 服务器配置类
创建NettyWebsocketServer配置类，负责初始化Netty服务器：
java复制@Slf4j
@Configuration
public class NettyWebsocketServer {
private EventLoopGroup bossGroup = new NioEventLoopGroup(1);
private EventLoopGroup workerGroup = new NioEventLoopGroup();
private ChannelFuture channelFuture;
@PostConstruct
public void start() throws InterruptedException {
try {
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.option(ChannelOption.SO_BACKLOG, 128)
.childOption(ChannelOption.SO_KEEPALIVE, true)
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel socketChannel) {
ChannelPipeline pipeline = socketChannel.pipeline();
// HTTP协议编解码器
pipeline.addLast(new HttpServerCodec());
// 支持大数据流传输
pipeline.addLast(new ChunkedWriteHandler());
// HTTP消息聚合
pipeline.addLast(new HttpObjectAggregator(8192));
// WebSocket协议处理器
pipeline.addLast(new WebSocketServerProtocolHandler("/chat"));
// 心跳检测
pipeline.addLast(new IdleStateHandler(60, 5, 0));
// 自定义业务处理器
pipeline.addLast(new ChatHandler());
}
});
channelFuture = b.bind(9091).sync();
if(channelFuture.isSuccess()) {
log.info("Netty server started on port 9091");
}
channelFuture.channel().closeFuture().sync();
} finally {
bossGroup.shutdownGracefully();
workerGroup.shutdownGracefully();
}
}
}
4.2 自定义处理器实现
创建ChatHandler处理WebSocket消息：
java复制public class ChatHandler extends SimpleChannelInboundHandler<TextWebSocketFrame> {
@Override
protected void channelRead0(ChannelHandlerContext ctx, TextWebSocketFrame msg) {
String receivedMsg = msg.text();
System.out.println("Received message: " + receivedMsg);
ctx.writeAndFlush(new TextWebSocketFrame("Server response: " + receivedMsg));
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {
cause.printStackTrace();
ctx.close();
}
}
这里使用SimpleChannelInboundHandler
而不是ChannelInboundHandlerAdapter，因为它会自动释放资源，避免内存泄漏。
5. 使用ApiFox进行调试
5.1 服务启动与连接
- 启动Spring Boot应用
- 在ApiFox中创建WebSocket连接：
- 地址：ws://localhost:9091/chat
- 成功连接后可以看到握手过程
5.2 消息收发测试
发送消息格式：
json复制{
"content": "Hello Netty"
}
服务端响应：
code复制Server response: Hello Netty
5.3 调试技巧
- 在ChatHandler中设置断点，观察消息接收过程
- 注意消息类型是TextWebSocketFrame，需要通过text()方法获取内容
- 响应时也需要封装成TextWebSocketFrame对象
6. 常见问题与解决方案
6.1 客户端收不到响应
问题现象：服务端处理了消息但客户端没有收到响应
原因分析：没有正确封装WebSocket帧类型
解决方案：
java复制// 错误方式
ctx.writeAndFlush("Server response: " + receivedMsg);
// 正确方式
ctx.writeAndFlush(new TextWebSocketFrame("Server response: " + receivedMsg));
6.2 连接频繁断开
问题现象：连接建立后很快断开
解决方案：
- 添加心跳检测
java复制pipeline.addLast(new IdleStateHandler(60, 5, 0));
- 调整TCP保持活动选项
java复制.childOption(ChannelOption.SO_KEEPALIVE, true)
6.3 大消息传输问题
问题现象：大消息传输不完整或失败
解决方案：
- 调整HttpObjectAggregator的maxContentLength
java复制pipeline.addLast(new HttpObjectAggregator(65536));
- 确保ChunkedWriteHandler在pipeline中
7. 性能优化建议
-
线程池配置：
- bossGroup线程数通常设为1即可，因为只需要处理连接请求
- workerGroup线程数建议设置为CPU核心数×2
-
内存管理：
- 使用池化的ByteBuf分配器
java复制
.option(ChannelOption.ALLOCATOR, PooledByteBufAllocator.DEFAULT) -
连接参数优化：
java复制.option(ChannelOption.SO_BACKLOG, 1024) .childOption(ChannelOption.TCP_NODELAY, true) -
日志优化：
- 添加LoggingHandler调试网络通信
java复制pipeline.addLast(new LoggingHandler(LogLevel.DEBUG));
8. 项目扩展方向
-
消息协议设计：
- 定义标准的消息格式（JSON/Protobuf）
- 添加消息类型字段区分不同业务
-
用户管理：
- 实现用户认证（JWT）
- 维护在线用户列表
-
群组聊天：
- 实现频道/群组功能
- 支持广播消息
-
消息持久化：
- 集成Redis或数据库存储历史消息
- 实现消息同步机制
在实际开发中，我发现Netty的线程模型需要特别注意，业务处理不应该阻塞I/O线程。对于耗时操作，应该提交到专门的业务线程池处理。另外，WebSocket协议的状态管理比HTTP复杂，需要仔细处理连接生命周期。