返回

SpringBoot优雅整合Netty实现WebSocket通信(初学者友好)

原创
admin的头像admin·发布于 2025-07-18 12:48·阅读 62

本文是为 Java 后端初学者 精心准备的一份图文教程,带你一步一步用 SpringBoot + Netty 搭建一个稳定高效的 WebSocket 实时通信服务。真正做到从零基础快速掌握核心实现原理和实战技巧。


✨ 为什么选择 Netty 来实现 WebSocket?

在实际开发中,我们常见的 WebSocket 实现方式包括使用 Spring 自带的 @ServerEndpoint、Tomcat 容器、SockJS 等。然而,当你需要面对更高并发、灵活处理底层连接、实现更优的性能扩展性时,Netty + SpringBoot 是一个更加优秀的选择。

✅ Netty 的优势:

  • 高性能 NIO 网络框架
  • 灵活可定制,适合底层网络协议开发
  • 更精细的连接管理、数据处理控制

🧱 技术准备

  • Java 8+
  • Spring Boot 2.x
  • Netty 4.x
  • Maven
  • IDE:IntelliJ IDEA 或 Eclipse

📦 项目结构预览

bash 复制代码
├── WebSocketNettyApplication.java
├── config/
│   └── NettyConfig.java
├── netty/
│   ├── WebSocketServer.java
│   ├── WebSocketChannelInitializer.java
│   └── WebSocketHandler.java

🧩 第一步:创建 SpringBoot 项目并添加依赖

pom.xml 中添加 Netty 依赖:

xml 复制代码
<dependencies>
    <!-- Spring Boot 核心依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>

    <!-- Netty 核心 -->
    <dependency>
        <groupId>io.netty</groupId>
        <artifactId>netty-all</artifactId>
        <version>4.1.86.Final</version>
    </dependency>
</dependencies>

🔧 第二步:编写 Netty 服务端配置

NettyConfig.java

java 复制代码
@Configuration
public class NettyConfig {
    @Value("${netty.port}")
    private int port;

    @Bean
    public WebSocketServer webSocketServer() {
        return new WebSocketServer(port);
    }

    @EventListener(ApplicationReadyEvent.class)
    public void start() {
        webSocketServer().start();
    }
}

application.yml 配置:

yaml 复制代码
netty:
  port: 8081

🧠 第三步:实现 WebSocket 服务核心逻辑

WebSocketServer.java

java 复制代码
public class WebSocketServer {
    private final int port;

    public WebSocketServer(int port) {
        this.port = port;
    }

    public void start() {
        EventLoopGroup bossGroup = new NioEventLoopGroup();
        EventLoopGroup workerGroup = new NioEventLoopGroup();
        try {
            ServerBootstrap bootstrap = new ServerBootstrap();
            bootstrap.group(bossGroup, workerGroup)
                     .channel(NioServerSocketChannel.class)
                     .childHandler(new WebSocketChannelInitializer());

            Channel ch = bootstrap.bind(port).sync().channel();
            System.out.println("WebSocket Server started at port " + port);
            ch.closeFuture().sync();
        } catch (InterruptedException e) {
            e.printStackTrace();
        } finally {
            bossGroup.shutdownGracefully();
            workerGroup.shutdownGracefully();
        }
    }
}

WebSocketChannelInitializer.java

java 复制代码
public class WebSocketChannelInitializer extends ChannelInitializer<SocketChannel> {
    @Override
    protected void initChannel(SocketChannel ch) {
        ChannelPipeline pipeline = ch.pipeline();
        pipeline.addLast(new HttpServerCodec());
        pipeline.addLast(new HttpObjectAggregator(65536));
        pipeline.addLast(new WebSocketServerProtocolHandler("/ws"));
        pipeline.addLast(new WebSocketHandler());
    }
}

WebSocketHandler.java

java 复制代码
public class WebSocketHandler extends SimpleChannelInboundHandler<TextWebSocketFrame> {
    @Override
    protected void channelRead0(ChannelHandlerContext ctx, TextWebSocketFrame msg) {
        System.out.println("接收到客户端消息:" + msg.text());
        ctx.channel().writeAndFlush(new TextWebSocketFrame("服务端响应:" + msg.text()));
    }

    @Override
    public void handlerAdded(ChannelHandlerContext ctx) {
        System.out.println("客户端连接:" + ctx.channel().id().asLongText());
    }

    @Override
    public void handlerRemoved(ChannelHandlerContext ctx) {
        System.out.println("客户端断开连接:" + ctx.channel().id().asLongText());
    }
}

🔍 第四步:启动项目进行测试

  1. 启动 SpringBoot 项目。

  2. 使用浏览器或 WebSocket 客户端(如:Postman、websocat、Socket.IO)连接地址:

    复制代码
    ws://localhost:8081/ws
  3. 发送消息,查看控制台与返回结果。


扩展

客户端(微信小程序)
wxml

复制代码
<view>接收的消息</view>
<textarea style="border: 1px solid black;" value="{{msg}}"></textarea>
<view>发送的消息</view>
<textarea style="border: 1px solid black;" bindinput='inputTitle'></textarea>
<button style="border: 1px solid violet;" bindtap='send'>发送消息</button>
<button style="border: 1px solid red;" bindtap='openWebSocket'>打开WebSocket连接</button>
<button style="border: 1px solid red;" bindtap='closeWebSocket'>关闭WebSocket连接</button>

js

复制代码
Page({
  /**
   * 页面的初始数据
   */
  data: {
  },
  /**
   * 生命周期函数--监听页面加载
   */
  onLoad: function (options) {
  },
  /**
   * 绑定参数
   */
  inputTitle: function(e){
    var _this = this;
    _this.setData({ title: e.detail.value })
  },
  /**
   * 发送信息
   */
  send: function(){
    var _this = this;
    wx.sendSocketMessage({ 
      data: _this.data.title ,
      success: (result) => {
        console.log(result)
      },
      fail: (result) => {
        console.log(result)
        wx.showToast({
          title: result.errMsg,
          icon:"none",
          duration:5000
        })
      },    
    })
  },
  /**
   * 打开连接
   */
  openWebSocket: function(){
    //创建一个 WebSocket 连接
    wx.connectSocket({
      url: 'ws://10.8.51.124:8000/ws',
      success: (result) => {
        console.log(result)
      },
    })
    //监听 WebSocket 连接打开事件
    wx.onSocketOpen(function (result) {
      console.log(result)
    })
    //监听 WebSocket 错误事件
    wx.onSocketError(function (result) {
      console.log(result)
      wx.showToast({
        title: result.errMsg,
      })
    })
    //监听 WebSocket 接受到服务器的消息事件
    wx.onSocketMessage((result) => {
      console.log(result)
      this.setData({
        msg: result.data
      })
    })
    //监听 WebSocket 关闭事件
    wx.onSocketClose((result) => {
      console.log(result)
    })
  },
  /**
   * 关闭连接
   */
  closeWebSocket: function(){
    wx.closeSocket({
      success: (result) => {
        console.log(result)
      },
    })
  }
})

📚 适合延伸阅读


🧾 总结

本文介绍了如何使用 SpringBoot 与 Netty 组合,手动实现一个 WebSocket 服务。相比于传统框架,Netty 提供了更灵活的连接管理能力与更高性能,适合构建 IM 聊天、实时通知、游戏服务等高并发实时系统。


🚀 你可以这样做练手!

  • 支持私聊与群聊
  • 自定义消息格式(JSON)
  • 心跳检测与重连机制
  • 与前端 Vue/React WebSocket 客户端对接

SEO 关键词:SpringBoot整合Netty, WebSocket实现方法, Java后端教程
SEO 描述:一步步教你如何用SpringBoot整合Netty实现WebSocket通信,初学者也能轻松掌握!


💡 如果这篇教程对你有帮助,别忘了点个赞 👍 或分享给正在学习 Java 后端开发的朋友!

作者的其他文章
IP地址配置HTTPS 内网IP配置HTTPS保姆教程
本文介绍了在Nginx中配置HTTPS的完整流程:1)使用OpenSSL生成自签名证书和私钥;2)解密私钥以避免重启时输入密码;3)配置Nginx支持HTTPS,包括指定证书路径、设置安全协议和加密套件等。适用于开发、测试和内网环境,但需注意自签名证书会触发浏览器警告,生产环境建议使用CA签发的正式证书。通过简单的命令和配置即可实现基本的HTTPS加密保护。
IP地址配置HTTPS 内网IP配置HTTPS保姆教程
Docker 数据目录迁移完整指南:从 /var/lib/docker 迁移到自定义路径
本文介绍了将 Docker 数据目录从 /var/lib/docker 迁移到自定义路径 /data2/docker/data 的完整过程,包括停止 Docker 服务、复制数据、修改配置文件及验证数据完整性。提供了常见问题的解决方案,帮助用户在空间不足时顺利迁移 Docker 数据。
Docker 数据目录迁移完整指南:从 /var/lib/docker 迁移到自定义路径
2025年必备:让Nginx配置清晰如诗的工具推荐
文章浏览阅读464次,点赞4次,收藏4次。本文介绍了格式化Nginx配置文件的重要性,指出良好格式能提升可读性、团队协作效率和降低错误风险。文章推荐了2025年优秀的在线格式化工具,这类工具应具备操作简单、专业格式化效果、安全保障等特性。建议将格式化工具集成到开发流程中,并制定团队规范,以优雅管理Nginx配置。文末推荐了一个专业在线格式化工具,帮助开发者高效处理配置文件。
2025年必备:让Nginx配置清晰如诗的工具推荐
Claude 命令大全:从入门到精通的终端操作指南(2025 最新)
本教程全面整理 *Claude 命令行(CLI)使用指南*,从基础启动命令、项目管理、权限控制、模型切换到高级思考模式,全方位提升开发者在终端中使用 Claude 的效率。适合新手与资深开发者收藏参考。
Claude 命令大全:从入门到精通的终端操作指南(2025 最新)
屏幕检测专家 — 专业的在线屏幕测试工具
屏幕检测专家 — 专业的在线屏幕测试工具
屏幕检测专家 — 专业的在线屏幕测试工具
Keye-VL-1.5-8B(快手 Keye-VL)— 腾讯云两卡 32GB GPU **保姆级** 部署指南(Ubuntu 22.04 / CUDA 12.2 / Driver 535.216.01 / Python 3.10)
保姆级教程:在腾讯云两卡 32GB GPU(Ubuntu 22.04 / CUDA 12.2)上完整部署快手 Keye-VL-1.5-8B。包含驱动安装、conda 环境、PyTorch、bitsandbytes、vLLM、ModelScope 模型下载与 Gradio demo 运行步骤及常见排错。适合工程复现与上线优化。
Keye-VL-1.5-8B(快手 Keye-VL)— 腾讯云两卡 32GB GPU **保姆级** 部署指南(Ubuntu 22.04 / CUDA 12.2 / Driver 535.216.01 / Python 3.10)
Ubuntu系统ECS重启后“/etc/resolv.conf”被还原怎么办?
处理方法 在处理前,建议先禁用systemd-resolved服务。 方法一:手动修改/etc/resolv.conf文件。 以root用户登录ECS。 关闭并禁用systemd-resolved服务
共享打印机报错连不上怎么办?修复错误代码(0x000006d9/0x0000011b 等)最新Win10/11 共享打印机常见问题 + 解决教程,附工具!
Win11 打印机共享报错全面修复指南:涵盖 0x000006d9、0x0000011b、0x0000007e 等常见码,并提供一键 PowerShell 工具,十分钟内搞定老款惠普共享打印机。
共享打印机报错连不上怎么办?修复错误代码(0x000006d9/0x0000011b 等)最新Win10/11 共享打印机常见问题 + 解决教程,附工具!
实战Spring Boot + Vue 集成 Activiti 工作流引擎 | 双模式简单 & 自定义审批平台
基于 Spring Boot 与 Vue 的高效工作流平台,支持简单模式与自定义模式双引擎,在线流程建模、版本管理、审批节点灵活配置,多渠道消息通知,Docker/K8s 部署,高可用与可扩展。
2025 年国内 Docker/DockerHub 镜像源加速列表(7 月 28 日更新 · 长期维护)
2025 年最新国内 Docker Hub 镜像源加速列表,包含轩辕镜像、腾讯云、阿里云、DaoCloud、AtomHub 等多家稳定 CDN 服务,附详细配置教程与常见问题说明,适用于 Linux、macOS、Windows 平台。
2025 年国内 Docker/DockerHub 镜像源加速列表(7 月 28 日更新 · 长期维护)