Source map 与堆栈跟踪

堆栈跟踪（Stack traces） ↗ 可在应用程序遇到未处理异常时帮助调试代码。堆栈跟踪会显示具体调用了哪些函数、调用顺序、来自哪一行和哪个文件，以及使用了哪些参数。

大多数 JavaScript 代码在部署到生产环境前会先打包、通常还会转译，然后进行压缩。此过程会生成更小的 bundle 以优化性能，并在需要时将 TypeScript 代码转换为 JavaScript。

Source maps 将编译和压缩后的代码映射回您编写的原始代码。Source maps 与 JavaScript 运行时返回的堆栈跟踪结合，向您呈现完整的堆栈跟踪。

要启用 source map，向 wrangler pages deploy 提供 --upload-source-maps 标志，或在使用 Pages 构建环境时向 Pages 应用的 Wrangler 配置文件 添加以下内容：

{
	"upload_source_maps": true
}

upload_source_maps = true

启用上传 source map 后，运行 wrangler pages deploy 时 Wrangler 会自动生成并上传 source map 文件。

当应用抛出未捕获异常时，我们会获取 source map 并将其用于将异常的堆栈跟踪映射回应用原始源代码的行。

然后可在流式传输 实时日志 时查看堆栈跟踪。

• 实时日志 - 了解如何实时捕获 Pages 日志。