ES6模块下Sentry反混淆未压缩代码报错且无法显示源码求助

问题背景 #

使用最新版自托管Sentry + @sentry/node，切换到ES模块（package.json设置type:module）后，Sentry控制台提示「无效的绝对路径URL」，无法显示未压缩的源码；但CommonJS模式下虽有提示却能正常展示源码。已按官方文档重新操作，问题仍存在。

核心原因 #

ES模块和CommonJS的文件路径解析逻辑存在差异，Sentry默认的路径处理在ES模块场景下无法正确适配自托管实例的源码关联规则，导致路径识别失败。

解决方案1：直接禁用源码映射解析（适合未压缩代码场景） #

如果代码未压缩，无需源码映射，可直接关闭Sentry的自动源码映射处理，强制捕获原始栈信息：

import * as Sentry from '@sentry/node';

Sentry.init({
  dsn: "你的DSN地址",
  tracesSampleRate: 1.0,
  // 强制捕获完整栈信息
  attachStacktrace: true,
  // 禁用自动源码映射上传与解析
  sourceMaps: {
    upload: false,
    filesToDeleteAfterUpload: []
  },
  // 可选：设置服务名称和版本，帮助区分环境
  serverName: 'your-service-name',
  release: '1.0.0'
});

解决方案2：修正路径映射（需要保留源码关联场景） #

如果需要Sentry正确关联本地源码结构，可通过路径规范化处理，将绝对路径转换为项目相对路径：

import * as Sentry from '@sentry/node';
import { normalizePaths } from '@sentry/utils';

Sentry.init({
  dsn: "你的DSN地址",
  tracesSampleRate: 1.0,
  attachStacktrace: true,
  // 预处理栈信息，将绝对路径转为项目相对路径
  beforeSend(event) {
    if (event?.exception?.values) {
      event.exception.values.forEach(ex => {
        ex.stacktrace?.frames?.forEach(frame => {
          frame.filename = normalizePaths(frame.filename, process.cwd());
        });
      });
    }
    return event;
  },
  // 指定项目根目录，帮助Sentry定位源码
  projectRoot: process.cwd()
});

验证步骤 #

1. 确认package.json中type已设置为module，无CommonJS/ES模块混用代码
2. 重启Node服务后主动触发错误（如示例中的foo()调用）
3. 检查Sentry控制台，确认栈信息中已显示正确的未压缩源码

内容的提问来源于stack exchange，提问作者Slice