Apple M1 Mac无法解析netty-transport-native-epoll的osx-aarch_64依赖

netty-transport-native-epoll是Netty针对Linux平台epoll IO机制封装的本地传输组件，本身从未提供过macOS（含M系列芯片的osx-aarch_64架构）的对应构建产物，无论使用哪个版本的Netty，都无法拉取到osx-aarch_64分类器的epoll依赖，这不是镜像源、网络或者配置错误，是该组件从设计上就仅支持Linux平台。
你能正常拉取netty-transport-native-kqueue的osx-aarch_64版本，是因为kqueue是BSD/macOS平台原生的高性能IO模型，Netty专门为macOS提供了对应适配。

• 按运行平台动态匹配依赖（推荐）
  不要在pom中硬编码epoll依赖的osx-aarch_64分类器，通过Maven Profile根据当前操作系统自动引入对应平台的native传输依赖：
  将原有固定声明的netty-transport-native-epoll依赖替换为如下配置：

  <dependencies>
    <!-- 跨平台通用的Netty核心依赖保留 -->
    <dependency>
      <groupId>io.netty</groupId>
      <artifactId>netty-transport</artifactId>
      <version>4.1.63.Final</version>
    </dependency>
  </dependencies>
  
  <profiles>
    <!-- Linux环境自动引入epoll适配 -->
    <profile>
      <id>linux</id>
      <activation>
        <os>
          <family>linux</family>
        </os>
      </activation>
      <dependencies>
        <dependency>
          <groupId>io.netty</groupId>
          <artifactId>netty-transport-native-epoll</artifactId>
          <version>4.1.63.Final</version>
          <!-- Linux x86_64用linux-x86_64，Linux arm64用linux-aarch_64 -->
          <classifier>linux-x86_64</classifier>
        </dependency>
      </dependencies>
    </profile>
    <!-- macOS环境自动引入kqueue适配 -->
    <profile>
      <id>macos</id>
      <activation>
        <os>
          <family>mac</family>
        </os>
      </activation>
      <dependencies>
        <dependency>
          <groupId>io.netty</groupId>
          <artifactId>netty-transport-native-kqueue</artifactId>
          <version>4.1.63.Final</version>
          <classifier>osx-aarch_64</classifier>
        </dependency>
      </dependencies>
    </profile>
  </profiles>
  

  代码层不要硬编码指定使用Epoll实现，增加运行时自动检测逻辑，根据当前环境加载可用的传输层实现：

  EventLoopGroup group;
  Class<? extends SocketChannel> channelClass;
  if (Epoll.isAvailable()) {
      group = new EpollEventLoopGroup();
      channelClass = EpollSocketChannel.class;
  } else if (KQueue.isAvailable()) {
      group = new KQueueEventLoopGroup();
      channelClass = KQueueSocketChannel.class;
  } else {
      // 全平台兜底用NIO实现
      group = new NioEventLoopGroup();
      channelClass = NioSocketChannel.class;
  }
  

  这套配置不管是本地M1 Mac开发，还是线上部署到Linux服务器，都能自动匹配对应依赖，不会出现找不到包的问题。
• 本地开发临时兜底
  如果只是在M1 Mac上做日常开发调试，线上才部署到Linux环境，直接将netty-transport-native-epoll的scope设置为provided，本地启动时不加载该依赖，用kqueue或者NIO实现启动即可，打包部署到Linux时再将该依赖打进构建产物。
• 强制使用epoll的场景
  如果本地开发必须依赖epoll专属特性（比如边缘触发、epoll独有的传输配置项），直接在M1 Mac上运行Linux aarch64版本的Docker容器或虚拟机，在Linux环境内开发调试，即可正常拉取和使用linux-aarch_64版本的epoll依赖。

内容的提问来源于stack exchange，提问作者Amit Gawali