如何解决Next.js中‘Module not found: Can't resolve '@napi-rs/snappy-...'’警告？

是否需要解决？ #

这些警告本质是@napi-rs/snappy的跨平台适配机制导致的——它会自动尝试加载对应当前系统架构的二进制包，但你的构建/运行环境不需要这些特定架构的包，因此抛出警告。

虽然目前不影响日志功能正常运行，但大量警告会污染构建日志，增加排查其他问题的难度；另外如果后续依赖更新或部署到其他环境，可能触发更严重的解析错误，建议处理。

处理方法 #

1. 关闭winston-loki的snappy压缩（最简单） #

如果日志传输不需要压缩，可以直接在winston-loki的 transporter 配置中关闭压缩功能，彻底避免加载snappy相关依赖：

import winston from 'winston';
import LokiTransport from 'winston-loki';

const logger = winston.createLogger({
  transports: [
    new LokiTransport({
      // 你的Grafana Loki配置（host、labels等）
      compress: false, // 关闭snappy压缩
      json: true
    })
  ]
});

2. 通过Webpack配置忽略无关架构的包 #

在next.config.js中添加Webpack插件，忽略当前环境不需要的@napi-rs/snappy架构包：

/** @type {import('next').NextConfig} */
const nextConfig = {
  webpack: (config) => {
    // 匹配所有出现警告的@napi-rs/snappy架构包
    config.plugins.push(
      new config.webpack.IgnorePlugin({
        resourceRegExp: /@napi-rs\/snappy-(linux-arm-gnueabihf|linux-x64-gnu|darwin-x64|darwin-arm64)/,
      })
    );
    return config;
  },
  // 保留之前配置的nextjs-node-loader
  module: {
    rules: [
      {
        test: /\.node$/,
        loader: "nextjs-node-loader",
      },
    ],
  },
};

module.exports = nextConfig;

根据你实际遇到的警告，补充对应的架构包名到正则表达式中即可。

3. 强制替换为纯JS版本的snappy #

通过package.json的overrides字段，强制winston-loki使用纯JS实现的snappyjs，避免依赖二进制架构包：

{
  "name": "your-project-name",
  "version": "1.0.0",
  "overrides": {
    "snappy": "npm:snappyjs@^0.7.1"
  },
  // 其他依赖配置
}

修改后执行npm install重新安装依赖，该方法会让所有依赖snappy的包都使用纯JS版本，彻底消除跨架构包的查找问题。

内容的提问来源于stack exchange，提问作者levente.nas