---
title: デバッウェブェブ
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/ja-jp/engine/6000.0/manual/platform-specific/webgl/develop/debugging/web-debugging-production
latest_url: https://docs.unity.com/ja-jp/engine/7000.0/manual/platform-specific/webgl/develop/debugging/web-debugging-production.md
last_updated: 2026-09-14
generated_at: 2026-11-16T07:53:14.875Z
locale: ja-jp
---

# デバッウェブェブ

> 外部シンボル、JavaScriptScript エラーハンドラー、スタックトレースマッピングを使用して、デプロイされた ウェブ ビルドをデバッグします。

外部シンボル、JavaScriptScript エラーハンドラー、スタックトレースマッピングを使用して、デプロイされた ウェブ ビルドをデバッグします。

Unity ウェブ ビルドは、ソースレベルのデバッグを完全にはサポートしていません。ただし、一部のデバッグ情報を保持し、ブラウザーエラーレポートを使用して、配備されたビルドのランタイムエラーを調査できます。

## 外部シンボルの使用##use-external-symbols

ウェブビルドで外部シンボルを有効にし (メニュー: Editor> **公開設定**> **デバッグ設定**> **外部**)、本番スタックトレースに機能名を含めます。外部シンボルを使用してビルドする場合、Unity はメインのビルド出力とは別にシンボルファイルを生成します。

キャッチされない JavaScript 例外が発生した場合、Unity は外部シンボルデータを使用して WebAssembly スタックフレームを IL2CPP が生成した C/C++ 機能名にマップすることができます。これらの名前は、元の Cクラスとメソッドを識別するのに十分な読みやすさがあります。

例えば、`PlayerController.Jump()` などの C# メソッドは、スタックトレースに `PlayerController_Jump_m<hash>` として表示されます。

外部シンボルを使用して、正確なソース行ではなく、エラーが発生した機能を識別します。

### スタックトレースをより正確に C# 名にマップ##map-stack-traces-more-precisely-to-c-names

より正確なマッピングが必要な場合、Unity はビルドプロセス中に`MethodMap.tsv`ファイルも生成します。このファイルは、IL2CPP によって生成されたメソッド名を元の C# メソッド名にマップするヘルプになります。これは特にオーバーロードされたメソッドに役立ちます。

Unity は`MethodMap.tsv`をビルド出力ディレクトリに自動的にコピーしません。以下にあります。

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

### 制限事項##limitations

外部シンボルには以下は含まれません。

* 正確な C# ソースファイル名
* 正確な C# 行番号
* 本番 ウェブ ビルドで C# コードを 1 行ずつステップ実行する機能

### ビルドサイズとランタイムへの影響##build-size-and-runtime-impact

外部シンボル ファイルはエラー調査にのみ必要であるため、Unity はメイン ビルドとは別に保存します。つまり、外部シンボルファイルは、ユーザーの最初のアプリケーションダウンロードには影響しません。

シンボルファイルは通常 1 \~ 2 MB 程度であり、デプロイしたビルドアーティファクトとともに格納できます。

Unity は外部シンボル ファイルをメインのビルド出力とは別に格納するため、このアプローチによる本番ビルドの初期ダウンロード サイズとランタイム パフォーマンスへの影響は最小限です。

## ブラウザー エラーのレポート##report-browser-errors

デプロイされた ウェブ ビルドからエラーレポートを収集するには、Unity コンテンツをホストするページに JavaScript エラーハンドラーを追加し、その結果を Analytics またはクラッシュレポートサービスに送信します。

便利なブラウザー フックには以下が含まれます。

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

これらのフックは、以下をキャプチャできます。

* Uncaught JavaScript exceptions
* 一部の WebAssembly ランタイムエラー
* ブラウザー エラー レポートに表示される一部のエンジン エラー

これらのレポートを外部シンボルと組み合わせると、本番スタックトレースを読みやすくなります。

## 追加リソース##additional-resources

* [ウェブビルドのデバッグとトラブルシューティング](/engine/6000.0/manual/platform-specific/webgl/develop/debugging.md)
* [開発中のウェブビルドのデバッグ](/engine/6000.0/manual/platform-specific/webgl/develop/debugging/web-debugging-development.md)
* [一般的なウェブビルドエラーのトラブルシューティング](/engine/6000.0/manual/platform-specific/webgl/develop/debugging/web-debugging-troubleshooting.md)
