<h2 id="%E6%A6%82%E8%A6%81" data-line="0" class="code-line">
<a class="header-anchor-link" href="#%E6%A6%82%E8%A6%81" aria-hidden="true"></a> 概要</h2>
<p data-line="2" class="code-line">こんにちは、ambr, Inc.でクライアントエンジニアをしているサックーです。<br>
この記事は<a href="https://adventar.org/calendars/10507" target="_blank" rel="nofollow noopener noreferrer">ambr, Inc. Advent Calendar 2024</a> 12日目の記事です。<br>
今回はUnityのIL2CPPで作ったWindowsアプリがクラッシュした原因を調査していく方法を紹介します。</p>
<p data-line="6" class="code-line">先日、エディタでは発生せずにビルドでのみ発生するクラッシュがありました。<br>
さらに、仕込んでいるログ出しでも原因を特定できませんでした。<br>
そこでクラッシュ時に生成されるdmpファイルを解析していきます。</p>
<h2 id="%E6%BA%96%E5%82%99" data-line="10" class="code-line">
<a class="header-anchor-link" href="#%E6%BA%96%E5%82%99" aria-hidden="true"></a> 準備</h2>
<h3 id="%E3%83%93%E3%83%AB%E3%83%89%E6%99%82%E3%81%AE%E8%A8%AD%E5%AE%9A" data-line="12" class="code-line">
<a class="header-anchor-link" href="#%E3%83%93%E3%83%AB%E3%83%89%E6%99%82%E3%81%AE%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> ビルド時の設定</h3>
<p data-line="14" class="code-line">Build Settingsにある<code>Copy PDB files</code>にチェックを入れてビルドします。<br>
<code>Development build</code>じゃなくて大丈夫です。</p>
<p data-line="17" class="code-line"><img src="https://res.cloudinary.com/zenn/image/fetch/s--0xfrfLsW--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/365c687650fa50f2031be88e.png%3Fsha%3D6a41c77959d93cb45b63fbcb06a5fc515325812b" loading="lazy" class="md-img"></p>
<p data-line="19" class="code-line">この状態でビルドすると、dllに対応したpdbファイルが含まれていることがわかります。</p>
<p data-line="21" class="code-line"><img src="https://res.cloudinary.com/zenn/image/fetch/s--S_592M_6--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/a674a827023279d0690d82af.png%3Fsha%3D68d30d8e7543df8514be27ca86ef4ae830b80eb1" loading="lazy" class="md-img"></p>
<h2 id="%E5%AE%9F%E8%B7%B5" data-line="23" class="code-line">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%B7%B5" aria-hidden="true"></a> 実践</h2>
<h3 id="dmp%E3%82%92%E8%A6%8B%E3%81%A4%E3%81%91%E3%82%8B" data-line="25" class="code-line">
<a class="header-anchor-link" href="#dmp%E3%82%92%E8%A6%8B%E3%81%A4%E3%81%91%E3%82%8B" aria-hidden="true"></a> dmpを見つける</h3>
<p data-line="27" class="code-line">まずは先ほどビルドしたものでクラッシュを発生させます。<br>
すると<code>C:\Users\【ユーザー名】\AppData\Local\Temp\【Company Name】\【Product Name】\Crashes</code>にクラッシュレポートが生成されているはずです。<br>
クラッシュタイミングごとにフォルダ分けされていて、その中にdmpファイルがあります。</p>
<p data-line="31" class="code-line"><img src="https://res.cloudinary.com/zenn/image/fetch/s--fv8MZfm5--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/037848aa331287b9c0de635f.png%3Fsha%3D3d364fb7668145bdb0d6325cea5e6eb8fd08b837" loading="lazy" class="md-img"></p>
<h3 id="windbg%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%84%E3%81%8F" data-line="33" class="code-line">
<a class="header-anchor-link" href="#windbg%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%84%E3%81%8F" aria-hidden="true"></a> WinDbgを使っていく</h3>
<h4 id="windbg%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" data-line="35" class="code-line">
<a class="header-anchor-link" href="#windbg%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> WinDbgのインストール</h4>
<p data-line="37" class="code-line">dmpファイルを解析するツールとしてWinDbgをインストールしておきます。</p>
<p data-line="39" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__4db450b26e9bb" src="https://embed.zenn.studio/card#zenn-embedded__4db450b26e9bb" data-content="https%3A%2F%2Flearn.microsoft.com%2Fja-jp%2Fwindows-hardware%2Fdrivers%2Fdebugger%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://learn.microsoft.com/ja-jp/windows-hardware/drivers/debugger/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://learn.microsoft.com/ja-jp/windows-hardware/drivers/debugger/</a></p>
<h4 id="%E3%83%91%E3%82%B9%E3%81%AE%E8%A8%AD%E5%AE%9A" data-line="41" class="code-line">
<a class="header-anchor-link" href="#%E3%83%91%E3%82%B9%E3%81%AE%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> パスの設定</h4>
<p data-line="43" class="code-line">先ほどインストールしたWinDbgを開き、pdbファイルへパスの設定をします。<br>
今回の使い方だとビルドごとに設定する必要があります。<br>
<code>File &gt; Settings &gt; Debugging settings &gt; Default symbol path</code>に行き、使用したビルド(＝dllとpdbファイルがある)のフォルダを指定してください。</p>
<p data-line="47" class="code-line"><img src="https://res.cloudinary.com/zenn/image/fetch/s--fqnplxPG--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/b073b8884e46574d179185de.png%3Fsha%3D7b702c271e5599caa05dc4199a512e99c2553da2" loading="lazy" class="md-img"></p>
<h3 id="dmp%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E8%A7%A3%E6%9E%90%E3%81%99%E3%82%8B" data-line="49" class="code-line">
<a class="header-anchor-link" href="#dmp%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E8%A7%A3%E6%9E%90%E3%81%99%E3%82%8B" aria-hidden="true"></a> dmpファイルを解析する</h3>
<p data-line="51" class="code-line">メインの画面に戻り、ワークスペース？にdmpファイルをD&amp;Dすると読み込んでくれます。<br>
<code>Path validation summary</code> がOKであればpdbファイルがちゃんと読み込まれていると思われます。</p>
<p data-line="54" class="code-line"><img src="https://res.cloudinary.com/zenn/image/fetch/s--TdwlU-mC--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/9676b9f1694837b27672f508.png%3Fsha%3D71430a781f8db0f18934a37b385559b7844755fc" loading="lazy" class="md-img"></p>
<p data-line="56" class="code-line">下の方に<code>!analyze -v</code>を実行せよとあり、それをクリックすると実行してくれます。</p>
<p data-line="58" class="code-line">真ん中くらいに発生した例外の情報があります。<br>
今回は<code>Access violation</code>、メモリアクセス違反のようです。</p>
<p data-line="61" class="code-line"></p>
<div class="code-block-container"><pre class="language-plaintext"><code class="language-plaintext code-line" data-line="62">EXCEPTION_RECORD:  (.exr -1)
ExceptionAddress: 00007ffc93372c1e (GameAssembly!U3CLoadImageAndOptimizeAsyncU3Ed__2_MoveNext_m96E89B2FAEEBE20E4FBCDFB489B9673973C0D1C5+0x000000000000059e)
   ExceptionCode: c0000005 (Access violation)
  ExceptionFlags: 00000000
NumberParameters: 2
   Parameter[0]: 0000000000000001
   Parameter[1]: 00000168f367a7d4
</code></pre></div><p data-line="71" class="code-line"></p>
<p data-line="73" class="code-line">さらに下の方に、クラッシュが起きた該当部分の情報があります。<br>
今回は<code>RawTextureUtil.cpp</code>の1580行目のようでした。</p>
<div class="code-block-container"><pre class="language-plaintext"><code class="language-plaintext code-line" data-line="76">FAULTING_SOURCE_FILE:  C:\actions-runner\_work\xambr-unity\xambr-unity\Unity\Library\Bee\artifacts\WinPlayerBuildProgram\il2cppOutput\cpp\RawTextureUtil.cpp

FAULTING_SOURCE_LINE_NUMBER:  1580
</code></pre></div><p data-line="82" class="code-line">これはUnityがビルド時に生成したcppファイルであり、ビルドしたマシンの該当パスに残っています。</p>
<h3 id="cpp%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E8%A6%8B%E3%82%8B" data-line="84" class="code-line">
<a class="header-anchor-link" href="#cpp%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E8%A6%8B%E3%82%8B" aria-hidden="true"></a> cppファイルを見る</h3>
<p data-line="86" class="code-line">実際に該当ファイルを見てみると以下の部分でした。</p>
<p data-line="88" class="code-line"><img src="https://res.cloudinary.com/zenn/image/fetch/s--6xWUdy2X--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/b906834e6287b9edfb0bcdd5.png%3Fsha%3D97c7997fc3362cf140cb93697c214390cb82e3bb" loading="lazy" class="md-img"></p>
<p data-line="90" class="code-line">なんと元のcsファイルの該当行をコメントで残してくれているので、<code>RawTextureUtil.cs</code>の144行目であるということが分かりました。<br>
処理内容から元のcsコードを推測する必要があると思っていたので、うれしい誤算でしたね。</p>
<p data-line="93" class="code-line">そしてcsファイルの該当箇所を確認したところ、今回は<code>NativeArray</code>への書き込み時に書き込み先が消えてしまっていたのが原因だと特定できました！</p>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81" data-line="95" class="code-line">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<p data-line="97" class="code-line">このようにして、クラッシュの原因をdmpファイルの解析で特定できました。<br>
不具合に対抗する手段が増えたので良かったです。<br>
似たような問題に悩んでいる方の助けになれば幸いです…！</p>


Unityで作ったWindowsアプリのクラッシュ原因を調査する

csharp

Discussion