本文档详细阐述了Spring Boot框架从2.2.x到2.7.x再到3.x版本的升级方案。

从 2.2.2 到 2.7，不只是数字的跃迁，更是架构的涅槃重生。

本文记录了从Kafka 2.x升级到3.x过程中遇到的三个典型问题及解决方案。首先遇到NoClassDefFoundError错误，原因是Kafka 3.0+重构了API，通过禁用Spring Boot的Kafka自动配置并手动配置Bean解决。其次发现依赖冲突问题，必须全面排查并排除所有依赖中的旧版本kafka-clients。最后禁用自动配置后导致缺少必要Bean，通过添加@EnableKaf

坑 1：用了不稳定的 Netty 5.x 版本 → 换成 4.1.87.Final坑 2：线程数配置不当 → bossGroup 设为 1，workerGroup 默认坑 3：没处理粘包/拆包问题 → 使用 LengthFieldBasedFrameDecoder坑 4：ByteBuf 内存泄漏 → 使用 SimpleChannelInboundHandler其实 Netty 也没多难，就是刚开始

/ 自定义线程数// bossGroup 通常设为 1// 后续代码与示例 1 相同// ...其实 Netty 的线程模型也没那么复杂，就是主从多线程 Reactor 模式。关键是要理解 bossGroup 和 workerGroup 的分工，合理配置线程数，避免阻塞 I/O 线程。我也是踩了几个坑才明白这些道理的。现在配置线程模型时，心里总算有底了。肯定有理解不对的地方，欢迎大佬指正。如果你也

Override@Override// 响应客户端// 记得释放 buf，否则会内存泄漏@Override@Override@Override@Override用 SimpleChannelInboundHandler：自动释放消息，避免内存泄漏合理配置线程数：bossGroup 1 个线程，workerGroup 默认使用内存池：生产环境用 PooledByteBufAllocator正确选择内

粘包：多个小数据包被合并成一个大数据包拆包：一个大数据包被分割成多个小数据包@Override// 确保有足够的字节可读return;// 不够，等更多数据// 读取长度// 重置读索引return;// 读取数据@Override// 写入长度// 写入数据魔数（4字节）：0xCAFEBABE版本（1字节）：1命令（1字节）：1-登录，2-消息，3-退出长度（4字节）：数据部分的长度数据（可变长

监听：在 Bean 销毁前执行预处理主动反注册：让注册中心立即推送下线通知设置运行标志：通知消费者停止 poll 循环等待时间窗口：给上游服务感知下线的时间线程池托管：让 Spring 自动管理线程池生命周期AtomicBoolean 防护：防止 Feign 子上下文事件冒泡通过以上方案，可以在 Spring Boot 2.2.x 版本实现完整的优雅停机，保障服务在滚动更新、手动发布等场景下的数据

新项目无脑选 Redis，老项目评估迁移成本再决定。欢迎关注，不错过后续更新。如有疑问或建议，欢迎在评论区交流。

本文的核心知识图谱：fill:#333;important;important;fill:none;color:#333;color:#333;important;fill:none;fill:#333;height:1em;Sentinel 高可用监控层判断层执行层PING 心跳（每秒）INFO 拓扑发现（每10秒）Pub/Sub 互相发现（每2秒）SDOWN → 个人判断ODOWN → 多数派