---
title: 调试生产 Web 构建
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/platform-specific/webgl/develop/debugging/web-debugging-production
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/platform-specific/webgl/develop/debugging/web-debugging-production.md
last_updated: 2026-09-14
generated_at: 2026-11-16T07:39:09.131Z
locale: zh-cn
---

# 调试生产 Web 构建

> 使用 External 符号、JavaScript 报错处理程序和 stack trace Mapping 来调试部署的 Web 构建。

使用 External 符号、JavaScript 报错处理程序和 stack trace Mapping 来调试部署的 Web 构建。

Unity Web 构建不Support完整的音频源代码关卡调试。但是，您可以保留一些调试信息并使用浏览器报错来调查已部署构建中的运行时故障。

## 使用External符号##use-external-symbols

在 Web 版本中启用 External 符号（菜单：Editor > **Publishing Settings** > **Debug Settings** > \*\* External\*\*）以在生产堆栈跟踪中包含函数名称。使用External符号进行生成When，Unity 会独立于主要生成输出生成符号文件。

发生未捕获的 Javascript 异常When，Unity 可以使用External符号数据将 WebAssembly 堆栈帧映射回 IL2CPP 生成的 C/C++ 函数名称。这些名称通常可读性足以识别原始 C# 类和方法。

例如，`PlayerController.Jump()` 等 C# 方法可能在 stack trace 中显示为 `PlayerController_Jump_m<hash>`。

使用External符号来标识发生故障的函数，而不是准确的音频源线。

### 将映射跟踪更精确地映射到 C# 名称##map-stack-traces-more-precisely-to-c-names

如果需要更精确的 Mapping，Unity 还会在版本过程中生成`MethodMap.tsv`文件。此文件可帮助将 IL2CPP 生成的方法名映射射回原始 C# 方法名称，这对于重载方法特别有用。

Unity 不会自动将`MethodMap.tsv`复制到版本输出目录。您可以在以下位置查找：

`Library/Bee/artifacts/WebGL/il2cppOutput/cpp/Symbols`

### 局限性##limitations

External 符号不包括：

* 准确的 C# 音频源文件名称
* 准确的 C# 线
* 能够在生产 Web 版本中逐行步骤完成 C# 代码

### 生成大小和运行时影响##build-size-and-runtime-impact

Unity 将 External 符号文件与主要版本分开存储，因为它们仅用于报错。这意味着 External 符号文件不会影响 Users 的初始应用程序 Download。

符号文件通常约为 1–2 MB，您可以将它们与部署的版本工件一起存储。

由于 Unity 将External符号文件与主要输出分开存储，因此此方法ON生产生成的初始Download大小和运行时时性性能的影响最小。

## 上报浏览器错误##report-browser-errors

要从部署的 Web 版本收集报错Reports，请在托管 Unity 内容的Page中添加 Javascript 报错处理程序，并将结果发送到 Analytics 或崩溃报告服务。

有用的浏览器挂钩包括：

* `window.onerror`
* `window.addEventListener('error', ...)`
* `console.error`

这些钩子可以捕获：

* 未捕获的 Javascript 异常
* 某些 WebAssembly 运行时错误
* 通过浏览器报错显示的一些引擎错误

您可以将这些Reports与External符号相结合，make生产堆栈跟踪更容易阅读。

## 其他资源##additional-resources

* [Web 构建的调试和 Troubleshoot](/engine/6000.0/manual/platform-specific/webgl/develop/debugging.md)
* [在 Development 中调试 Web 构建](/engine/6000.0/manual/platform-specific/webgl/develop/debugging/web-debugging-development.md)
* [Troubleshoot 常见 Web 版本错误](/engine/6000.0/manual/platform-specific/webgl/develop/debugging/web-debugging-troubleshooting.md)
