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
相关产品推荐
相关产品推荐

