Netty：channelInactive 与 channelUnregistered
一、channelInactive 与 channelUnregistered 的区别
Netty 中，channelInactive() 和 channelUnregistered() 都属于 ChannelInboundHandler 的生命周期回调方法，但代表的含义不同。
核心区别：
channelInactive()：关注 TCP 连接是否仍然有效。channelUnregistered()：关注 Channel 是否仍注册在 EventLoop 中。
二、channelInactive()
当 Channel 从活动状态变为非活动状态时，Netty 会触发 channelInactive()。
@Override
public void channelInactive(ChannelHandlerContext ctx) {
System.out.println("连接断开：" + ctx.channel().remoteAddress());
}常见触发场景：
客户端主动关闭 TCP 连接。
服务端主动关闭 TCP 连接。
网络异常导致连接被 Netty 检测到并关闭。
对于普通 TCP Channel，触发 channelInactive() 后，可以认为该 TCP 连接已经断开，不能继续用于正常的数据通信。
但是需要区分：
客户端已经断开连接。
服务端已经检测到客户端断开连接。
这两件事情不一定同时发生。
例如客户端突然断电，服务端可能无法立即感知，需要通过 TCP 超时、心跳检测等方式发现连接失效。
因此，channelInactive() 代表 Netty 已经检测到连接不再活动，而不是所有网络故障发生时都能立即收到回调。
三、channelUnregistered()
当 Channel 从 EventLoop 的注册关系中注销时，Netty 会触发 channelUnregistered()。
@Override
public void channelUnregistered(ChannelHandlerContext ctx) {
System.out.println("Channel 已注销：" + ctx.channel().id());
}Netty 的 NIO 模型通过 EventLoop 管理 Channel。
一个 EventLoop 可以管理多个 Channel，并通过 Selector 监听这些 Channel 的 IO 事件。
EventLoop
|
|---- Channel A
|
|---- Channel B
|
|---- Channel C当 Channel 注销后，它不再通过原来的 EventLoop 注册关系参与 IO 事件处理。
channelUnregistered() 不等于 TCP 断开事件。
例如，Channel 可能因为注册关系变更而注销，不一定意味着底层 TCP 连接立即关闭。
因此不建议仅通过 channelUnregistered() 判断客户端是否离线。
四、Netty Channel 完整生命周期
一个典型的 TCP Channel 生命周期如下：
创建 Channel
|
v
channelRegistered()
|
| 注册到 EventLoop
v
channelActive()
|
| TCP 连接建立
v
channelRead()
|
| 读取客户端数据
|
v
正常业务通信
|
| 客户端或服务端关闭连接
v
channelInactive()
|
| Channel 不再活动
v
channelUnregistered()
|
| 从 EventLoop 注销
v
CLOSED说明：
channelRegistered()：Channel 注册到 EventLoop。channelActive()：Channel 进入活动状态。channelRead()：接收到数据时触发，可以多次调用。channelInactive()：Channel 不再活动。channelUnregistered()：Channel 从 EventLoop 注销。
以上是正常建立并关闭 TCP 连接的典型流程。实际情况下，Channel 可能在尚未建立 TCP 连接时就完成注册，也可能在未激活前就注销。
五、如何判断 TCP 连接是否断开？
Netty 提供三个常用方法：
Channel channel = ctx.channel();
// Channel 是否打开
boolean open = channel.isOpen();
// Channel 是否活动
boolean active = channel.isActive();
// Channel 是否注册到 EventLoop
boolean registered = channel.isRegistered();区别：
例如：
if (channel != null && channel.isActive()) {
channel.writeAndFlush(message);
}需要注意：
isActive() 为 true，不代表客户端一定在线。
例如：
客户端突然断电。
服务端尚未检测到 TCP 连接异常。
此时
channel.isActive()可能仍然返回 true。后续通过心跳超时、TCP 检测或 IO 错误，才能发现连接异常。
因此，在长连接系统中，通常需要结合心跳机制和业务回执判断连接是否真正可用。
六、连接断开处理示例
例如，一个 Netty TCP 服务端需要维护客户端连接状态。
1. 建立连接
@Override
public void channelActive(ChannelHandlerContext ctx) {
Channel channel = ctx.channel();
System.out.println("连接建立：" + channel.id());
}2. 连接断开
@Override
public void channelInactive(ChannelHandlerContext ctx) {
Channel channel = ctx.channel();
System.out.println("连接断开：" + channel.id());
// 清理连接关联的业务资源
removeConnection(channel);
}3. Channel 注销
@Override
public void channelUnregistered(ChannelHandlerContext ctx) {
System.out.println("Channel 注销：" + ctx.channel().id());
}通常建议在 channelInactive() 中处理连接离线及相关业务资源清理，而不是等到 channelUnregistered()。
4. 防止旧连接清理新连接
假设客户端采用唯一设备编号管理 TCP 长连接。
设备 A 建立连接 Channel-1
|
v
记录映射：A → Channel-1
|
v
设备 A 断线并快速重连
|
v
更新映射：A → Channel-2
|
v
旧 Channel-1 触发 channelInactive()
|
v
如果直接根据设备编号删除
可能误删 Channel-2推荐使用条件删除：
// 存储设备编号与 Channel 的映射关系
private final ConcurrentHashMap<String, Channel> connections =
new ConcurrentHashMap<>();
// 连接关闭时，只删除与当前旧 Channel 匹配的映射
connections.remove(deviceId, ctx.channel());ConcurrentHashMap 属于 Java 8 自带的 java.util.concurrent 包。
该操作只有在设备编号当前对应的 Channel 与指定 Channel 匹配时才会删除映射。
可以避免旧连接关闭时误删新连接。
七、常见问题与答案
1. channelInactive() 触发后，是否可以认为 TCP 已经断开？
可以。对于正常的 Netty TCP Channel，触发该方法说明 Netty 已经确认 Channel 不再处于活动状态。
但网络故障发生后，可能需要一段时间才能触发该方法。
2. channelInactive() 与 channelUnregistered() 有什么区别？
前者表示 Channel 不再活动，后者表示 Channel 从 EventLoop 注销，分别对应连接活动状态和 IO 注册状态。
3. 为什么 TCP 断开后还需要 channelUnregistered()？
因为连接关闭与 IO 注册关系清理是不同的操作。
TCP 连接已经失效后，Netty 还需要完成相应的注册关系清理。
4. channelInactive() 一定比 channelUnregistered() 先执行吗？
对于正常建立并关闭的 TCP Channel，通常是先触发 channelInactive()，再触发 channelUnregistered()。
但不能将这一顺序理解为所有 Channel 场景下的绝对规则。
5. isActive() 为 true，能否证明客户端在线？
不能。它只能表示当前 Netty Channel 处于活动状态，无法保证远端设备一定正常运行。
6. 应该在哪个方法中删除客户端在线状态？
通常在 channelInactive() 中处理。
如果存在客户端快速重连，需要检查旧连接是否仍然是当前有效连接，避免误删新连接。
八、重点总结
channelRegistered()：Channel 注册到 EventLoop。channelActive()：Channel 进入活动状态。channelRead()：Channel 收到数据。channelInactive()：Channel 不再活动，通常用于处理 TCP 断开。channelUnregistered()：Channel 从 EventLoop 注销。channel.isActive()：只能反映 Netty 当前检测到的连接状态，不能保证远端一定在线。长连接系统应结合心跳、超时检测与业务回执判断连接可用性。
客户端快速重连时，应避免旧 Channel 的关闭事件误删新 Channel 的连接信息。
核心区别：channelInactive 关注连接活动状态，channelUnregistered 关注 Channel 的 EventLoop 注册状态。