生产环境 sourceMap 不能通过浏览器自动加载，必须上传至 Sentry 等平台服务端映射；Webpack 用 hidden-source-map，Vite 配 sourcemap: true 后上传；路径、JS 内容一致性及版本精确匹配是还原关键。
能定位，但必须绕开浏览器自动加载的路径——生产环境的 sourceMap 不能靠 //# sourceMappingURL= 注释或 SourceMap 响应头暴露给所有人。
为什么浏览器自动解析在生产环境基本失效
现代构建工具（如 Webpack、Vite）默认在生产构建中禁用公开的 Source Map，因为：
-
//# sourceMappingURL=注释会把.map文件 URL 暴露在 JS 源码末尾，任何用户都能下载并还原全部源码 - HTTP
SourceMap响应头同样需要服务端显式返回，等同于开放源码访问入口 - 主流监控平台（Sentry / HyperDX / Bugsnag）明确要求关闭浏览器端自动加载，改用服务端映射
所以你看到的错误堆栈仍是 at a (app.min.js:123:45)，不是配置漏了，而是故意没让它生效。
必须上传到错误监控平台，而非部署到 CDN
核心动作是：构建后，把 .map 文件上传到 Sentry 或 HyperDX 等平台，由它们在服务端完成映射。常见操作差异：
- Webpack 推荐用
devtool: 'hidden-source-map'：生成.map文件，但不插入注释，避免泄露 - Vite 需设
build.sourcemap: true，再配合 CLI 上传；build.sourcemap: 'inline'会把 map 内联进 JS，体积暴涨且仍暴露源码 - Sentry CLI 上传时，
--url-prefix必须与线上 JS 资源的 URL 路径严格一致，例如线上 JS 是https://cdn.example.com/static/js/app.a1b2c3.js，就要传--url-prefix '~/static/js/' - HyperDX 使用
hyperdx-cli sourcemaps upload时，--app-version必须和错误上报时 SDK 设置的版本完全相同，否则匹配失败
还原失败的三个高频原因
即使上传成功，堆栈仍显示混淆名，大概率卡在这几个环节：
-
sourceMappingURL路径和实际上传路径不一致：比如构建输出dist/js/app.js.map，但上传命令指向./dist/app.js.map，文件名或层级错一位就无法关联 - JS 文件本身被二次处理：CDN 自动压缩、反向代理重写、或 Nginx 启用了
gzip_static on却没同步提供.map.gz，导致平台拿到的 JS 内容与 map 文件记录的原始内容不匹配 - 多个版本混用：Sentry 中存了
v1.2.0的 map，但前端上报错误时 SDK 的release字段写成了v1.2或1.2.0-rc，版本字符串不精确匹配即跳过映射
本地快速验证是否生效（不依赖线上监控）
不用等错误上报，直接用 Node.js + source-map 库做一次手动解析：
const { SourceMapConsumer } = require('source-map');
const fs = require('fs');
<p>const rawMap = fs.readFileSync('./dist/app.min.js.map', 'utf8');
const consumer = await new SourceMapConsumer(rawMap);</p><p>// 模拟错误位置：app.min.js 第 123 行，第 45 列
const orig = consumer.originalPositionFor({
line: 123,
column: 45,
source: 'app.min.js'
});</p><p>console.log(orig); // { source: 'src/utils/api.ts', line: 42, column: 18, name: 'getUserProfile' }</p>
如果 orig.source 返回空或仍是 app.min.js，说明 map 文件本身没正确关联原始源码，问题出在构建阶段而非上传阶段。
