NestJS集成Sentry Source Maps映射异常排查求助

针对你的情况，核心问题是栈帧路径与上传的Source Maps路径不匹配，导致Sentry无法完成原始代码映射。以下是具体排查和修复方向：

1. 修正RewriteFrames配置逻辑 #

你当前的RewriteFrames代码逻辑完全倒置——我们需要把栈帧里的dist路径转换为src原始代码路径，而非相反：

new RewriteFrames({
  iteratee: (frame) => {
    if (!frame.filename) return frame;
    // 将栈帧中的dist路径替换为src路径，保留原有目录结构
    frame.filename = frame.filename.replace(/^app:\/\/\/dist\//, 'app:///src/');
    return frame;
  },
})

2. 调整Sentry CLI上传命令的URL前缀 #

栈帧文件路径前缀是app:///dist/，上传Source Maps时必须指定对应前缀，确保Sentry能关联栈帧与上传文件：

# 替换为你的org、project和release变量
sentry-cli sourcemaps upload \
  --org your-org-slug \
  --project your-project-slug \
  --release $SENTRY_RELEASE \
  --url-prefix 'app:///dist' \
  --validate \
  dist

• 加上--validate参数可自动检查Source Maps格式、路径匹配问题，快速定位上传错误。

3. 修正tsconfig的sourceRoot配置 #

当前sourceRoot: "/"会生成绝对路径的Source Map，易与Sentry映射逻辑冲突，建议改为相对路径：

{
  "compilerOptions": {
    // ... 其他配置
    "sourceRoot": "./src", // 指向项目src目录
    "inlineSources": true
  }
}

修改后生成的Source Map中，sources数组会是src/http-app/health-check.controller.ts这类相对路径，更易与转换后的栈帧路径匹配。

4. 确认SDK与CI的Release一致性 #

确保NestJS的Sentry SDK配置了和CI上传时完全一致的release值：

// main.ts 中的Sentry初始化
Sentry.init({
  dsn: 'your-dsn',
  release: process.env.SENTRY_RELEASE, // 该变量需与CI创建版本、上传Source Maps时的release完全一致
  // ... 其他配置
});

Release不匹配会导致Sentry无法找到对应版本的Source Maps。

5. 验证Sentry后台的Source Maps状态 #

进入Sentry项目「设置」→「Source Maps」，找到对应release检查：

• 每个.js文件都有对应的.map文件关联
• 点击.map文件查看详情，确认sources数组里的路径是正确的原始代码路径（如src/http-app/health-check.controller.ts）
• 若有错误/警告提示，按提示修复（如路径不匹配、Source Map格式错误）

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