34、Netty源码分析:ChannelPipeline的close

用 EmbeddedChannel 核对 close 出站操作与 inactive 入站事件的不同顺序,说明调用起点的影响。

简明结论

close 操作与 channelInactive 事件方向不同,实际路径取决于处理器接口、调用位置与转发行为。

close 是出站操作,channelInactive 是入站事件。在只有两个双向处理器 A、B 且按该顺序添加的示例中,从 Channel 发起 close 会先经过 B 再到 A;关闭后的 inactive 事件则从 A 到 B。两条路径不能混在一张箭头图里理解。

可执行的事件顺序测试

使用前一篇 HelloWorld 的共享 POM,将下列类保存到 src/test/java/site/NettyCloseTest.java。

package site;

import io.netty.channel.*;
import io.netty.channel.embedded.EmbeddedChannel;
import java.util.ArrayList;
import java.util.List;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class NettyCloseTest {
  @Test void closeAndInactiveHaveDifferentDirections() {
    var events = new ArrayList<String>();
    class Handler extends ChannelDuplexHandler {
      private final String name;
      Handler(String name) { this.name = name; }
      public void close(ChannelHandlerContext ctx, ChannelPromise promise) {
        events.add("close-" + name);
        ctx.close(promise);
      }
      public void channelInactive(ChannelHandlerContext ctx) {
        events.add("inactive-" + name);
        ctx.fireChannelInactive();
      }
    }
    var channel = new EmbeddedChannel(new Handler("A"), new Handler("B"));
    try {
      channel.close().syncUninterruptibly();
      assertEquals(List.of("close-B", "close-A", "inactive-A", "inactive-B"), events);
      assertFalse(channel.isOpen());
      System.out.println("close=B>A; inactive=A>B; open=false");
    } finally {
      channel.finishAndReleaseAll();
    }
  }
}
mvn -Dtest=NettyCloseTest test

本次输出 close=B>A; inactive=A>B; open=false。断言同时检查事件顺序与通道关闭状态。处理器必须继续调用相应的 ctx 方法,拦截后不转发会改变后续传播。

调用位置会改变起点

这里使用 channel.close(),从 pipeline 的出站入口发起;在某个处理器内部调用 ctx.close(),起点与可经过的处理器范围不同。pipeline 中仅实现入站或出站接口的处理器,也不会同时出现在两条链上。

本轮用 EmbeddedChannel 验证这组同步本地生命周期,不包含真实 socket 关闭、远端断开、异常竞态、不同 EventExecutor 或 unregister 的全部时序。不要据此推导所有生产关闭回调一定按同一列表出现。

下一步阅读

历史截图

以下为原资料截图,保留作历史参考,不是本轮验证结果。正文中的文字与示例可独立阅读。

历史资料截图 1(非本轮运行结果)

历史资料截图 2(非本轮运行结果)

历史资料截图 3(非本轮运行结果)

历史资料保留链接:https://blog.csdn.net/Lanna_w/article/details/130117086。