🧹
Unity の Burst エラーを BurstCache 削除で直したメモ

2026/05/07に公開
Unity で作業していたら、Console に Burst まわりの赤エラーが出るようになった。
今回出ていたのは System.Reflection.TargetInvocationException から System.TypeInitializationException につながって、Unity.Burst.Intrinsics や Unity.Burst.BurstCompiler.Compile がスタックに出てくるタイプのもの。
最初は package の依存関係やコード側の問題かと思ったけど、Packages/manifest.json の Burst / Collections / Mathematics の組み合わせ自体は特に変な状態ではなかった。
{
  "com.unity.burst": "1.8.29",
  "com.unity.collections": "2.2.1",
  "com.unity.mathematics": "1.3.3"
}
こういうときは、Burst のキャッシュが壊れている可能性を先に疑うのが早そうだった。

 BurstCache を手動で消すUnity を閉じてから、プロジェクトの Library/BurstCache を削除する。
今回のプロジェクトではここ。
D:\GitHub\VLiveKit_sandbox\Library\BurstCache
Library 配下なので、これは Unity が再生成するキャッシュ。git に入れるものではないし、消してもプロジェクトのソースそのものは消えない。
手順はこれだけ。
Unity を閉じる

Library/BurstCache を削除する
Unity を開き直す
開き直したあと、Burst の赤エラーは消えた。

 メモLibrary 配下は基本的に Unity の生成物なので、git に入れない。Library/BurstCache も同じ扱いで、詰まったときは削除して再生成させる。
今回のように Unity.Burst.Intrinsics や BurstCompiler.Compile が絡む初期化エラーで、package の依存関係が明らかに壊れていないなら、まず Library/BurstCache を消して確認するのが早かった。
GitHubで編集を提案
BurstCache を手動で消す

メモ

Discussion
