必须依赖构建时生成并部署的sourcemap或mapping.txt等映射文件才能还原混淆后的行号；浏览器需HTTPS可访问且无跨域拦截，Android需保留调试属性并用retrace.jar反解，iOS需匹配.dSYM UUID，平台解析不准常因源码与构建产物不一致。
混淆后堆栈里看不到真实行号，怎么还原？
混淆（如 Terser、ProGuard、R8）会重命名变量、函数、类，甚至删掉调试信息，导致生产环境上报的 Error.stack 里全是 a、b、fn123 这类名字，行号也对不上原始源码。这不是“看不清”，而是原始映射关系被主动剥离了——没 sourcemap，就真没路可回。
关键判断：**堆栈本身无法自行还原行号；必须依赖构建时生成并部署的 sourcemap 文件，且需确保其路径可被错误采集 SDK 正确加载。**
- 浏览器端 JS 错误：sourcemap 必须托管在可公开访问的 HTTPS 地址，且
//# sourceMappingURL=xxx.map注释不能被构建工具误删 - Android（R8/ProGuard）：需保留
-keepattributes SourceFile,LineNumberTable，并上传mapping.txt到符号服务器（如 Firebase Crashlytics 或 Sentry） - iOS（Swift/OC）：需上传
.dSYM包，且 UUID 必须与崩溃日志中Binary Images段完全匹配
sourcemap 加载失败的三个高频原因
即使你生成了 sourcemap，90% 的线上定位失败其实卡在加载环节，而非解析环节。
-
404或403：sourcemap 路径写死为相对路径（如./app.min.js.map），但实际部署在 CDN 子路径下（如https://cdn.example.com/v2.3.1/app.min.js），导致浏览器尝试请求https://cdn.example.com/v2.3.1/app.min.js.map失败 - 跨域拦截：CDN 未配置
Access-Control-Allow-Origin: *，浏览器拒绝读取 sourcemap 内容（控制台报Failed to load source map） - sourceRoot 干扰：sourcemap 中
sourceRoot字段指向本地开发路径（如/Users/name/project/src），导致解析器找不到原始.ts文件——该字段应为空或设为""，避免参与路径拼接
Android mapping.txt 映射时为什么总是对不上方法名？
ProGuard/R8 混淆后，堆栈里出现的 com.a.b.c.d.e.f(Unknown Source:0) 不代表没映射，而是你没用对工具或参数。
- 必须用官方工具反解：
retrace.jar（Android SDK 提供）或java -jar proguard/lib/retrace.jar -verbose mapping.txt crash.log，别手写正则替换 - 确保
mapping.txt与 APK 完全对应：同一个 Git commit、同一套构建命令、未开启minifyEnabled false的 debug 构建产物混用 - 注意行号偏移：混淆可能合并空行或删除注释，
Unknown Source:0往往对应原文件中第一个可执行语句，不是第 0 行——要结合上下文逻辑和日志时间戳交叉验证
Sentry / Firebase 上堆栈已解析但行号仍不准？
这类平台会自动 fetch sourcemap 或 mapping.txt 并做在线解析，但它们默认信任你上传的“原始源码”版本。一旦源码和构建产物不一致，解析结果就是错的。
- 检查上传的 source context 是否包含
//# sourceMappingURL注释：Sentry 要求 sourcemap 和 minified JS 同时上传，且 JS 文件末尾不能被构建插件（如HtmlWebpackPlugin）删掉该注释 - Firebase Crashlytics 要求
mapping.txt上传时指定正确的 build ID（Gradle 插件自动生成），而不是手动拖拽——否则它根本不会关联到这次崩溃 - 最隐蔽的坑：TypeScript 编译选项
inlineSources: true会让 sourcemap 把源码直接嵌进.map文件；若你又单独上传了.ts文件，Sentry 可能优先读取外部文件，造成行号错位
真正难的从来不是“有没有 sourcemap”，而是“这个 sourcemap 对应哪次构建、跑在哪台机器上、被谁改过路径、有没有被缓存污染”。线上定位慢，多半是这些链路里某一个环节静默失效了。
