You need to enable JavaScript to run this app. NextJS项目导入onesignal-node提示Can't resolve 'fs'错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

NextJS项目导入onesignal-node提示Can't resolve 'fs'错误如何解决

报错原因

  • onesignal-node 是服务端专用的Node.js SDK,依赖fs、net等Node.js原生核心模块,这类模块在浏览器运行环境中不存在。
  • Next.js的_app.js属于同构代码,会同时在服务端渲染阶段和客户端浏览器阶段执行,直接在该文件中导入onesignal-node,客户端执行阶段找不到对应原生模块就会抛出该错误。

解决方案

情况1:需要调用OneSignal服务端能力(如发送推送、管理用户数据)

不要在_app.js这类同构/客户端代码里导入onesignal-node,仅在仅服务端执行的代码中使用:

  • Next.js的服务端API路由(Pages Router的pages/api/目录下文件,App Router的app/api/目录下的路由处理文件)
  • getServerSideProps、getStaticProps等仅服务端运行的生命周期函数

示例代码(以Pages Router的pages/api/send-notification.js为例):

// 仅在服务端代码中导入和初始化
import * as OneSignal from 'onesignal-node';

const client = new OneSignal.Client('你的OneSignal App ID', '你的Rest API密钥');

export default async function handler(req, res) {
  try {
    const notification = {
      contents: { en: '测试推送' },
      included_segments: ['All']
    };
    const result = await client.createNotification(notification);
    res.status(200).json({ success: true, data: result });
  } catch (err) {
    res.status(500).json({ success: false, error: err.message });
  }
}

情况2:需要在客户端集成OneSignal前端推送能力

不要使用onesignal-node这个服务端SDK,改用OneSignal官方的前端Web SDK,通过Next.js的Script组件引入即可,不要使用服务端版本的依赖。

临时兼容方案(不推荐,仅用于临时调试)

如果需要先解决打包报错问题,可以在next.config.js中配置客户端打包时忽略Node.js原生模块:

/** @type {import('next').NextConfig} */
const nextConfig = {
  webpack: (config, { isServer }) => {
    if (!isServer) {
      config.resolve.fallback = {
        ...config.resolve.fallback,
        fs: false,
        net: false,
        tls: false
      };
    }
    return config;
  }
};

module.exports = nextConfig;

注意:该配置仅能解决打包报错问题,onesignal-node的相关方法依然无法在客户端正常调用,生产环境不建议使用该方案。

内容的提问来源于stack exchange,提问作者MomasVII

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 22:42:02