Next.js项目接入Sentry后执行yarn dev无法启动服务问题求助
问题解决方案
核心原因
触发报错的根源有两点:
next.config.js的配置写法存在逻辑缺陷,先赋值module.exports再读取赋值给其他变量,后续又重写module.exports,引发了模块加载的循环依赖问题- Sentry默认的服务端注入逻辑会在开发服务启动时尝试读取构建产物目录,未提前构建的情况下就会抛出找不到
.next目录的错误
修复步骤
1. 修正next.config.js配置写法
不要提前赋值module.exports,先定义好基础配置对象再处理,同时添加开发环境适配参数,修改后配置如下:
const { withSentryConfig } = require('@sentry/nextjs'); // 先定义基础Next.js配置 const nextConfig = { // 原有Next.js配置放在这里,为空就保持空对象即可 } const SentryWebpackPluginOptions = { silent: true, // 开发环境下禁用Sentry的构建插件,避免提前读取构建产物 disableServerWebpackPlugin: process.env.NODE_ENV === 'development', disableClientWebpackPlugin: process.env.NODE_ENV === 'development', }; // 仅生产环境套用Sentry配置,开发环境直接导出基础配置规避兼容问题 let moduleExports = nextConfig if (process.env.NODE_ENV === 'production') { moduleExports = withSentryConfig(nextConfig, SentryWebpackPluginOptions) } module.exports = moduleExports
2. 可选兼容操作
如果修改配置后仍报错,执行以下操作即可解决:
- 先执行一次
yarn build生成.next构建目录,之后再启动yarn dev就能正常运行 - 检查
@sentry/nextjs版本是否和Next.js大版本匹配:Next.js 12对应7.x版本的Sentry包,Next.js 13及以上版本对应8.x及以上版本的Sentry包 - 若开发环境不需要Sentry的任何功能,直接在开发环境下不使用
withSentryConfig包裹配置即可完全规避兼容问题
内容的提问来源于stack exchange,提问作者Phùng Ngọc Sơn
相关产品推荐
相关产品推荐

