You need to enable JavaScript to run this app. Next.js项目接入Sentry后执行yarn dev无法启动服务问题求助
优惠活动
大模型
产品
解决方案
定价
更多

Next.js项目接入Sentry后执行yarn dev无法启动服务问题求助

问题解决方案

核心原因

触发报错的根源有两点:

  1. next.config.js的配置写法存在逻辑缺陷,先赋值module.exports再读取赋值给其他变量,后续又重写module.exports,引发了模块加载的循环依赖问题
  2. 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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.11 05:51:03