is not a @Sharable handler解决方法

最新推荐文章于 2025-08-07 09:51:53 发布
原创 最新推荐文章于 2025-08-07 09:51:53 发布 · 9.7k 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#netty #sharable

本文记录了一次在使用Netty框架时遇到的关于编码器和解码器的问题，特别是在与Spring框架整合时，不当使用@Autowired注解注入单例导致的错误及解决方法。介绍了如何正确地为每个连接创建新的实例来避免此类问题。
部署运行你感兴趣的模型镜像

昨天在写编码器的时候,因为是和spring整合,因此在使用编码的时候用Autowired自动注入

@Autowired
private ProtocolDecoder protocolDecoder ;

@Autowired
private ProtocolEncoder protocolEncoder;

结果在多个客户端连接(其实不是多客户端的问题)的时候导致一直在报错,如下

io.netty.channel.ChannelPipelineException: com.sim.server.game.net.coder.decoder.ProtocolDecoder is not a @Sharable handler, so can't be added or removed multiple times.

于是我就自作聪明的将ProtocolDecoder上加了个@Sharable注解,结果在启动的时候就报错了。

Caused by: java.lang.IllegalStateException: ChannelHandler com.sim.server.game.net.coder.decoder.ProtocolDecoder is not allowed to be shared

最后的解决方法是,不要使用单例了,每次添加handler的时候直接new

        pipeline.addLast("decoder",new ProtocolDecoder() );
        pipeline.addLast("encoder",new ProtocolEncoder()) ;

当然如果是在ChannelInitializer的子类报错说is not a @Sharable handler,一般情况加上@Sharable注解即可。

您可能感兴趣的与本文相关的镜像

Seed-Coder-8B-Base

Seed-Coder-8B-Base

文本生成
Seed-Coder

Seed-Coder是一个功能强大、透明、参数高效的 8B 级开源代码模型系列，包括基础变体、指导变体和推理变体，由字节团队开源

一个网络请求在 Netty 中的旅行
悟已往之不谏，知来者之可追
12-25 329
Netty 在服务端启动时会为创建 NioServerSocketChannel，当客户端新连接接入时又会创建 NioSocketChannel，不管是服务端还是客户端 Channel，在创建时都会初始化自己的 ChannelPipeline。如果把 Netty 比作成一个生产车间，那么 Reactor 线程无疑是车间的中央管控系统，ChannelPipeline 可以看作是车间的流水线，将原材料按顺序进行一步步加工，然后形成一个完整的产品。本次梳理一遍网络请求在 Netty 中的处理流程，并着重讲解 Ch
Netty(十三)——ChannelHandler之意
学会改变自己——才能突破
11-30 1697
       上篇我们讲述了消息容器ChannelPipeline的相关知识，这篇我们来看下由它管理的，负责对I/O事件或者I/O操作进行拦截和处理，可以选择性的拦截和处理自己感兴趣的事件，也可以透传和终止事件的传递，也是由我们亲自实现的ChannelHandler业务处理。而Netty也帮我们实现一些通用的Handler，我们直接用就可以，前边写的例子中应该都有体会。我们还是来先看知识思维导图吧...
10. 成功解决：io.netty.channel.ChannelPipelineException: ***Handler is not a @Sharable handler...
水滴的博客
10-22 2736
io.netty.channel.ChannelPipelineException: ***Handler is not a @Sharable handler, so can't be added or removed multiple times.
Decoder is not a @Sharable handler, so can't be added or removed multiple times
weixin_30216561的博客
12-03 2809
Decoder is not a @Sharable handler, so can't be added or removed multiple times final MyMessageDecoder myMessageDecoder = new MyMessageDecoder(); 每次都new 一个不采用final 转载于:https://www.cnblogs.c...
Netty5_消息解析之ByteToMessageDecoder_源码解析
hotbain01的专栏
01-30 749
摘要 正文 源代码分析代码注释 总结摘要 ByteToMessageDecoder在Netty5处理的过程中起着很重要的作用，主要就是进行字节累积对象的管理工作 欢迎大家关注我的微博 http://weibo.com/hotbain 会将发布的开源项目技术贴通过微博通知大家，希望大家能够互勉共进！谢谢！也很希望能够得到大家对我博文的反馈，写出更高质量的文章！！ 正文源代码分析(代码注
Netty_Is Not a @Sharable handler异常
liby的博客
11-23 4418
在学习netty创建连接的时候产生一个报错 io.netty.channel.ChannelPipelineException: com.py.netty.server.DefaultServerHandler is not a @Sharable handler, so can't be added or removed multiple times. 在服务端, 传入处理器的时候, 使用...
netty多handler报错：“is not a @Sharable handler ”
w592376568的博客
04-11 5649
    1、项目要求多个Handler处理发送过来的各类消息，我本地新建了多个Handler类，再采用Spring注入的方式注入到服务端，客户端中后，报错：is not a @Sharable handler...................参考：https://my.oschina.net/xinxingegeya/blog/295577两种解决方法，要么就是加上注解@Sharable，要么...
自定义协议编解码：Codec（encode\decode）及Sharble注解详解
one2excellent的博客
06-04 1158
魔术：判断是否是无效数据包。版本号：可以支持协议的升级。序列化算法（对消息正文进行序列化以及反序列化）：json、protobuf、hessian、jdk。指令类型：如登陆、注册、单聊、群聊跟业务相关的。请求序号：为了双工通信，提供异步能力。正文长度：消息正文：@Data/*** 根据消息类型字节，获得对应的消息 class* @param messageType 消息类型字节自定义协议编解码：Codec（encode\decode）及Sharble注解详解。所以我们上面自定义编解码器也不能加@Sharab
Springboot——整合netty通过websocket通信并能根据type区分处理类跳转
专注写bug
08-07 784
在之前的博客中，着重说明了如何使用netty整合websocket实现通信功能。但在实际的项目中，一个netty服务对应一个端口所有的操作都在一个处理类中，显得过于杂乱。于是乎，就想着能不能根据传递参数，比如消息中携带一个type，做不用的处理逻辑跳转。就像适配器一样！自定义注解只是为了区别哪些bean对象是需要根据type做区分处理。@Target(ElementType.TYPE) // 仅作用于类上/*** 指定类型* @return*/
Netty 中的 handler 和 Pipeline
rickiyang的博客
05-23 1084
上一节我们讲了 Netty 的启动流程，从启动流程入手分析了 Reactor 模型的第一步：channel 如何绑定 Selector。然后讲到了 EventLoop 在启动的时候发挥了什么作用。整个启动类我们从头到尾过了一遍，今天我们来解决上节遗留的问题：Selector 如何将请求交给对应的 handler处理。 1. handler 的初始化 还是先从启动类入手： ServerBootstrap server = new ServerBootstrap().group(bossGroup,workGr
Netty中重连可能出现 is not a @Sharable handler 报错的处理方法
weixin_43194854的博客
01-20 5455
学习目标： https://blog.csdn.net/wb_snail/article/details/106263470?spm=1001.2101.3001.6661.1&utm_medium=distribute.pc_relevant_t0.none-task-blog-2%7Edefault%7ECTRLIST%7Edefault-1.opensearchhbase&depth_1-utm_source=distribute.pc_relevant_t0.none-task-bl
netty4_is not a @Sharable handler
weixin_34177064的博客
07-28 193
2019独角兽企业重金招聘Python工程师标准>>> ...
dotnetty报错xxxHandler is not @Sharable
void_main()的博客
06-17 517
因为在初始化Hanlder的时候没有new Handler ServerHandler serverHandler = new ServerHandler(); serverHandler.ReceivedData += ServerHandler_ReceivedData; var workerGroup = new Multi...
针对于Netty中重连可能出现 is not a @Sharable handler 报错的处理方法
GinChou的萌新博客
09-12 4446
is not a @Sharable handler 报错的处理方法 在创建服务端后 clien重连服务端 会报错 is not a @Sharable handler 我在网上查后一个很简单的方法 在ServerChannel类上添加@ChannelHandler.Sharable注解就可以了 截图如下: 这个注解适用于标注一个channel handler可以被多个chann...
@sharable handler,so can't be added or removed multiple times
程序猿学社的博客
12-11 8937
@sharable handler,so can't be added or removed multiple times 1.场景 netty集成springboot出现如上报错，像网上的事例，大部分都是没有继承springboot，例如下面代码 集成springboot的代码： 因是通过注入的方式，而不是通过new 解决方案： 增加@Sharable...
关于netty的@Sharable注解含义，你可bie瞎说了
wb_snail的博客
05-21 3913
@Sharable的真实含义 1.当netty尝试往多个channel中添加同一个ChannelHandlerAdapter实例时，会判断该实例类是否添加了@Sharable，没有则抛出... is not a @Sharable handler, so can't be added or removed multiple times异常 如果你用的不是单例Handler，你加不加@Sharable没有任何区别 如果你添加的是单例Handler，只要它会被添加到多个channe...
解决netty重复添加channel handler失败及其带来的反思
tinysakura的博客
07-23 2738
前言 使用netty作为nio框架开发遇到了一个问题，断线重连时添加自定义channel handler失败，抛出异常 ChannelPiplineException:"xxx class is not a @Sharable handler, so can't be added or removed multiple times 字面意思上是我们自定义的channel handler不是一个共...
Netty源码分析——@Sharable以及handler被重复添加到pipline的分析
保暖透气大裤衩LeoLee的博客
12-10 1036
二刷Netty源码的时候又有了新的认识，特此记录。 @Sharable是什么 在我们按照Netty变成范式的编写过程中，会编写一个Handler的配置类，也就是继承ChannelInitializer抽象类，并重写initChannel方法，大致如下： package com.leolee.netty.secondExample; import io.netty.channel.ChannelInitializer; import io.netty.channel.ChannelPipeline;
springboot需要多例对象但Autowire创建为单例问题解决
wflsyf的博客
11-06 1379
问题 我使用Autowire时，发现每次创建的handler对象都一样，导致neety报com.cqupt.nettyserver.ServerHandler is not a @Sharable handler, so can't be added or removed multiple times.错误，我在组件上添加了@Scope("prototype")//不加为单例，因为每次新的连接到来之后都需要分配一个新的对象，所以需改为多例注解还是不行，因为Spring IOC默认是单例。 解决方案 1、在需
@ChannelHandler.Sharable 有什么作用
最新发布
12-31
<think>我们正在讨论Netty中的@ChannelHandler.Sharable注解。根据引用[1]和引用[3]，这个注解的作用是标记一个ChannelHandler可以被多个ChannelPipeline共享（即同一个实例可以添加到多个Channel的pipeline中）。如果没有这个注解，Netty会在每次初始化pipeline时要求创建一个新的handler实例，如果尝试多次添加同一个实例（没有@Sharable）会抛出IllegalStateException。 引用[2]提到了一个场景：在.childHandler()中初始化Channel时，如果尝试复用同一个handler实例而没有加@Sharable，就会遇到问题。 总结一下： 1. **作用**：@Sharable注解允许一个ChannelHandler实例被安全地添加到多个ChannelPipeline中（即多个Channel共享同一个handler实例）。这可以节省内存和减少创建对象的开销。 2. **要求**：被标记为@Sharable的handler必须是线程安全的，因为多个Channel（可能属于不同的EventLoop）会同时访问它。 3. **使用场景**：当你希望多个Channel共享同一个handler实例时使用。通常，无状态的handler（例如某些统计用的handler）可以设置为共享。 注意：如果没有@Sharable注解，则每个ChannelPipeline都需要一个新的handler实例。如果尝试将同一个实例添加到多个pipeline而没有注解，Netty会抛出异常。 使用示例： ```java @ChannelHandler.Sharable public class MySharableHandler extends ChannelInboundHandlerAdapter { @Override public void channelRead(ChannelHandlerContext ctx, Object msg) { // 处理逻辑，注意：必须线程安全 } } // 在初始化时，可以复用同一个实例 MySharableHandler sharedHandler = new MySharableHandler(); ServerBootstrap b = new ServerBootstrap(); b.group(bossGroup, workerGroup) .channel(NioServerSocketChannel.class) .childHandler(new ChannelInitializer<SocketChannel>() { @Override public void initChannel(SocketChannel ch) { // 这里使用同一个实例添加到多个channel的pipeline中 ch.pipeline().addLast(sharedHandler); } }); ``` 如果不加@Sharable，上述代码会抛出异常，因为Netty检测到同一个handler实例被添加到多个pipeline。 因此，使用@Sharable注解的条件是： - Handler必须是线程安全的（因为会被多个线程同时访问）。 - 确实需要共享同一个实例（例如，为了节省资源或共享状态）。 如果不满足这些条件，则不要使用该注解，而是每次调用`new`创建一个新的handler实例。 相关问题： 1. Netty中如何保证@Sharable handler的线程安全？ 2. 哪些情况下不适合使用@Sharable注解？ 3. 如何避免在Netty中重复创建相同的handler实例？ </think> ### Netty 中 `@ChannelHandler.Sharable` 注解的作用详解 `@ChannelHandler.Sharable` 是 Netty 框架中一个重要的注解，主要解决 **ChannelHandler 实例在多 Channel 间的共享问题**。其核心作用如下： #### 1. **允许单例共享（核心功能）** - **使用场景**：当多个 Channel 的 Pipeline 需要添加相同逻辑的 Handler 时 - **效果**：添加此注解后，**同一个 Handler 实例可被安全地添加到多个 ChannelPipeline 中** - **示例**： ```java @ChannelHandler.Sharable // 关键注解 public class StatsHandler extends ChannelInboundHandlerAdapter { private final AtomicLong requestCount = new AtomicLong(); @Override public void channelRead(ChannelHandlerContext ctx, Object msg) { requestCount.incrementAndGet(); ctx.fireChannelRead(msg); } } ``` 在初始化时只需创建一次： ```java StatsHandler stats = new StatsHandler(); // 单例 // 多个 Channel 复用同一个实例 bootstrap.childHandler(new ChannelInitializer<SocketChannel>() { @Override protected void initChannel(SocketChannel ch) { ch.pipeline().addLast(stats); // ✅ 允许重复添加 } }); ``` #### 2. **避免 `IllegalStateException` 异常（安全机制）** - **未注解时**：Netty 默认要求每个 ChannelPipeline 使用独立的 Handler 实例，否则抛出： ```java IllegalStateException: handler not added to pipeline yet ``` - **添加注解后**：显式声明 Handler 是线程安全的，允许跨 Channel 复用[^2] #### 3. **资源优化** - **减少对象创建**：避免为每个 Channel 重复创建相同 Handler - **降低 GC 压力**：共享实例减少内存分配频率 - **适用场景**：统计类、日志类等**无状态**或**线程安全**的 Handler[^3] --- ### ⚠️ 使用注意事项 1. **线程安全强制要求** 被注解的 Handler **必须确保线程安全**，因为多个 Channel 会并发访问同一实例： ```java // 错误示例：非线程安全 private int count; // 多线程写会导致数据错乱 // 正确做法：使用原子变量 private final AtomicInteger count = new AtomicInteger(); ``` 2. **禁止共享的场景** 以下情况**不应使用** `@Sharable`： - Handler 包含 Channel 特定状态（如 `Channel` 的 `attr()`） - 涉及用户会话数据（如登录状态） - 使用非线程安全集合（如 `ArrayList`） 3. **与 `ChannelInitializer` 的关系** `ChannelInitializer` 本身自带 `@Sharable`，但初始化后会自动从 Pipeline 移除，不影响业务 Handler 的共享性。 --- ### 典型应用场景 | 场景类型 | 是否适用 `@Sharable` | 示例 | |-------------------|---------------------|-------------------------------| | 全局请求计数器 | ✅ 适用 | 统计服务器吞吐量 | | 链路追踪 Handler | ✅ 适用 | 记录请求日志（无状态） | | 用户会话管理器 | ❌ 不适用 | 存储用户登录状态 | | 业务逻辑处理器 | ❌ 不适用 | 处理订单（含业务状态） | > **关键设计原则**：只有当 Handler 的**逻辑与 Channel 无关**且**线程安全**时才使用此注解[^1]。 --- ### 相关问题 1. 如何在 Netty 中实现线程安全的共享 Handler？ 2. 为什么 `ChannelInitializer` 可以不加 `@Sharable` 注解？ 3. Netty 中哪些内置 Handler 使用了 `@Sharable` 注解？ 4. 如何诊断由非线程安全 Handler 引发的并发问题？ [^1]: 引用自关于 `@ChannelHandler.Sharable` 的单例特性讨论 [^2]: 引用自 `ClosedChannelException` 与 `@Sharable` 的关联案例 [^3]: 引用自 Netty 官方对 `@Sharable` 的源码说明
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值