Unityでアセットを追加しようとしたのに、なぜか読み込めない。Importを押しても反応しなかったり、Package Managerでエラーが出たり、入れたはずのアセットがAssetsフォルダに見つからなかったりすると、かなり焦りますよね。
特に制作中のプロジェクトで起きると、「プロジェクトが壊れたのかな」「Unityを再インストールしないとダメかな」と不安になるかもしれません。私も最初のころは、原因を切り分けずにあれこれ試して、かえって時間を使ってしまったことがあります。
アセットが読み込めないトラブルは、アセット自体の問題だけでなく、ファイルパス、キャッシュ、ネットワーク、Package Manager、Unityのバージョンなど複数の原因が関係します。大切なのは、いきなり大きな対処をするのではなく、自分の症状に近いものから順番に確認することです。
まずは「ダウンロードできない」のか、「インポートできない」のか、「インポート後に表示されない」のかを見分けながら、原因を絞っていきましょう。
Unityでアセットが読み込めない時は症状から原因を切り分けよう
Unityでアセットが読み込めない時は、まず「どこで止まっているのか」を確認します。ここを飛ばしてしまうと、ネットワークの問題なのにLibraryを削除したり、アセット破損なのにUnityを入れ直したりして、遠回りになりやすいです。
最初に見るポイントは、次の3つです。
| 症状 | 疑う場所 | 最初に確認すること |
|---|---|---|
| ダウンロードできない | Asset Store・Package Manager・ネットワーク | 通信エラーやログイン状態 |
| インポートできない | アセットファイル・ファイルパス・キャッシュ | Consoleのエラー内容 |
| 入れたのに表示されない | 保存場所・インポート結果・フィルター表示 | AssetsフォルダとProjectウィンドウ |
ダウンロードできない
Asset Storeの「Download」が進まない、Package Managerでパッケージ一覧が表示されない、途中で通信エラーが出る場合は、インポート前の段階で止まっています。
この場合は、アセットの中身よりも、Unity Hubへのログイン状態、ネットワーク接続、プロキシ、ファイアウォールなどを先に確認した方が効率的です。特に学校や会社のネットワークでは、セキュリティ設定によってUnity関連の通信が制限されることがあります。
インポートできない
ダウンロードはできているのに、Importボタンを押した後で止まる場合は、アセットファイルやプロジェクト側の状態を疑います。
例えば、ファイルパスが長すぎる、フォルダ名に日本語や特殊文字が含まれている、ダウンロードしたパッケージが壊れている、Libraryフォルダのキャッシュに不整合がある、といった原因が考えられます。
この段階では、まずConsoleウィンドウを開いて、赤いエラーが出ていないかを確認してください。エラー文が分かれば、やみくもに設定を変えずに済みます。
インポートしたのに表示されない
Importは完了したように見えるのに、Assetsフォルダに見つからない場合は、Projectウィンドウの表示や検索条件も確認します。
よくあるのは、検索欄に文字が残っていて表示が絞り込まれているケースです。また、アセットによってはフォルダ名が販売ページの名前と違うこともあるため、Projectウィンドウの検索欄を空にしてから、Assetsフォルダ全体を確認してみてください。
症状を分けて見るだけで、次に試すべき対処がかなり絞れます。自分の状況が「インポートできない」に近い場合は、まずプロジェクト内のファイルパスやキャッシュから確認していきましょう。
Unityでアセットをインポートできない原因と対処法
ダウンロードまではできているのにインポートで止まる場合は、プロジェクト内の保存場所やキャッシュ、アセットファイルの状態を確認します。Unity本体を入れ直す前に、安全に試せるところから順番に見ていくのがおすすめです。
ファイルパスが長すぎる
プロジェクトの保存場所が深い階層にあると、アセット内のファイル名と合わさってパスが長くなり、正常にインポートできない場合があります。
例えば、次のようにフォルダ階層が長い場所に置いている場合は注意してください。
C:\Users\UserName\Documents\Unity\Practice\GameProject\Backup\Version01\MyProjectこの場合は、プロジェクトをできるだけ浅い場所へ移動します。
C:\UnityProjects\MyProject判断基準は、「特定の大型アセットだけ失敗する」「フォルダ階層がかなり深い」「エラー文にpathやfile名が含まれる」などです。心当たりがある場合は、プロジェクト名や親フォルダ名も短くしてから再インポートしてみてください。
古いアセットでは日本語フォルダ名も影響する場合があります。
アセットファイルが壊れている
ダウンロード中に通信が切れたり、キャッシュが中途半端に残ったりすると、アセットファイル自体が壊れた状態になることがあります。
Consoleに次のような内容が出る場合は、破損したキャッシュを疑います。
Couldn't decompress packageこの場合は、Unityを閉じてから該当アセットを再ダウンロードします。Asset Store経由の場合は、My Assetsからもう一度ダウンロードし直すと改善することがあります。
判断基準は、「同じアセットだけ毎回失敗する」「ダウンロード途中で止まったことがある」「解凍やdecompressに関するエラーが出る」場合です。
Libraryを再生成する
プロジェクト内のLibraryフォルダは、Unityがアセットを読み込むために作るキャッシュのような場所です。ここに不整合が起きると、アセットが正しく読み込まれないことがあります。
Libraryを再生成する手順は次の通りです。
- Unityを閉じる
- 対象プロジェクトのフォルダを開く
Libraryフォルダを削除する、または別名に変更する- Unityでプロジェクトを開き直す
- 再インポートが終わるまで待つ
Libraryフォルダを削除しても、通常はAssetsフォルダ内のスクリプトや素材は消えません。ただし、再インポートには時間がかかるため、作業前にプロジェクトのバックアップを取っておくと安心です。
古いアセット自体が現在のUnityに対応していない場合もあります。互換性が疑わしい場合は、コチラの記事も確認してみてください。
ここまで確認してもインポート前に止まる場合は、アセットではなくPackage ManagerやAsset Store側の通信で止まっている可能性があります。
Package Manager・Asset Storeでダウンロードできない原因
アセットのImport画面まで進めない場合は、プロジェクト内の問題ではなく、Package ManagerやAsset Storeとの通信で止まっている可能性があります。
この段階でLibraryを削除しても、原因がネットワーク側にある場合は解決しにくいです。まずは「Unityがアセットを取得できる状態か」を確認していきましょう。
インターネット接続を確認する
最初に、ブラウザでUnity Asset StoreやUnity公式サイトを開けるか確認します。ブラウザでは見られるのにUnity側だけ失敗する場合は、Unity Hubのログイン状態やPackage Managerの通信が止まっている可能性があります。
判断基準は次の通りです。
- Asset StoreのDownloadが進まない
- Package Managerの一覧が表示されない
- My Assetsが空に見える
- Unity Hubでログインが外れている
一度Unity Hubからサインアウトして、再度ログインし直すだけで改善することもあります。特に購入済みアセットが表示されない場合は、別アカウントでログインしていないかも確認してください。
プロキシ・SSL証明書を確認する
学校や会社のネットワークでは、通信を確認するためにプロキシやSSL検査が入っていることがあります。この環境では、Unityが通信先の証明書を信頼できず、Package Managerが失敗する場合があります。
ConsoleやPackage Managerのログに、次のような文が出ている場合はこの可能性があります。
unable to get local issuer certificate個人の自宅回線ではあまり出にくい症状なので、心当たりがなければ深追いしなくて大丈夫です。学校・会社・共有Wi-Fiでだけ失敗するなら、別の回線で試すか、ネットワーク管理者にUnity関連の通信が制限されていないか確認してください。
ファイアウォールを確認する
セキュリティソフトやWindows Defenderのファイアウォールが、Unity EditorやUnity Package Managerの通信を止めていることもあります。
判断基準は、ブラウザではネットにつながるのに、UnityのPackage Managerだけ接続できない場合です。特に新しくセキュリティソフトを入れた直後や、会社のPCで発生した場合は確認してみてください。
確認する時は、Unity Editor、Unity Hub、Unity Package Manager関連の通信がブロックされていないかを見ます。
設定を変更する場合は、むやみにファイアウォール全体を無効化するのではなく、Unity関連の通信だけを許可する方が安全です。Unity Hubが古い場合は更新してください。
Consoleエラーから原因を特定する方法
原因がはっきりしない時は、UnityのConsoleウィンドウを確認します。Consoleには、Unityがどこで失敗したのかを示す手がかりが出ることがあります。
Consoleは、Unity上部メニューの Window から General、そして Console を選ぶと開けます。赤いエラーが出ている場合は、最初の1行だけで判断せず、エラーをクリックして詳細も確認してください。
Couldn’t decompress package
Couldn't decompress package は、パッケージの解凍に失敗した時に出ることがあります。ダウンロードしたファイルが途中で壊れていたり、キャッシュが不完全な状態で残っていたりする場合に疑います。
このエラーが出た時は、同じアセットを何度もImportし直すより、いったんUnityを閉じてから再ダウンロードを試す方が安全です。Asset Store経由のアセットなら、My Assetsから再取得してみてください。
判断基準は、「特定のアセットだけ失敗する」「ダウンロード中に止まったことがある」「decompressやpackageという単語が出ている」場合です。
unable to get local issuer certificate
unable to get local issuer certificate は、Unityが通信先の証明書を正しく確認できない時に出ることがあります。自宅回線よりも、学校や会社などの管理されたネットワークで起きやすいエラーです。
この場合は、アセットファイルやLibraryを触る前に、使っているネットワーク環境を確認してください。別の回線では成功するなら、プロキシやSSL検査が関係している可能性があります。
判断基準は、「Package Managerで発生する」「学校や会社のWi-Fiだけ失敗する」「certificateという単語が出ている」場合です。
Could not establish a connection with Unity Package Manager
Could not establish a connection with Unity Package Manager は、Unity EditorとPackage Managerの通信がうまくいっていない時に出ることがあります。
このエラーが出た場合は、まずUnityを再起動し、それでも直らなければUnity Hubも閉じて開き直します。改善しない場合は、セキュリティソフトやファイアウォールがUnity関連の通信を止めていないか確認してください。
判断基準は、「Package Managerが開かない」「パッケージ一覧が読み込まれない」「connectionやPackage Managerという単語が出ている」場合です。
Consoleのエラーは、すべてを暗記する必要はありません。大事なのは、エラー文の中にある package、certificate、connection などの単語から、ファイルの問題なのか、通信の問題なのかを分けることです。
エラーから原因を絞っても解決しない場合は、次に「今のプロジェクトだけで起きているのか」を確認すると、さらに判断しやすくなります。
それでも解決しない時の確認ポイント
ここまで試しても直らない場合は、無理に設定を変え続けるよりも、「Unity本体の問題なのか」「今のプロジェクトだけの問題なのか」「アセット側の問題なのか」を分けて確認します。
この切り分けをすると、不要な再インストールや設定変更を減らせます。特に制作途中のプロジェクトでは、原因を決めつけずに小さく試すことが大切です。
Unityのバージョンを確認する
古いアセットや更新が止まっているアセットは、現在使っているUnityのバージョンに対応していない場合があります。特に、昔のUnity向けに作られたエディタ拡張やシェーダー系アセットは、Unityの更新によってエラーが出ることがあります。
判断基準は、「古いアセットだけ失敗する」「販売ページの対応Unityバージョンが古い」「別の新しいアセットは問題なく入る」場合です。
この場合は、すぐにUnityのバージョンを変えるのではなく、まずアセットの販売ページやドキュメントで対応バージョンを確認してください。互換性が原因なら、プロジェクト側を直しても解決しないことがあります。
アセットが最新版へ対応しているか確認する
アセットによっては、Unityの新しいバージョンやURP、HDRPなどのレンダーパイプラインに対応するため、アップデートが必要になることがあります。
判断基準は、「インポート後にピンク色になる」「PrefabがMissingになる」「シェーダーやスクリプトのエラーが大量に出る」場合です。
Asset StoreのMy Assetsから更新版が出ていないか確認し、必要であれば最新版へ更新します。ただし、制作中のプロジェクトでいきなり更新すると別の不具合が出る場合もあるため、バックアップを取ってから試すのがおすすめです。
新規プロジェクトでも再現するか試す
最後の切り分けとして、新しい空のプロジェクトを作り、同じアセットをインポートしてみます。これで原因の場所をかなり絞れます。
| 結果 | 考えられる原因 | 次に見る場所 |
|---|---|---|
| 新規プロジェクトでも失敗する | Unity本体・ネットワーク・アセット側の問題 | Unity Hub、Package Manager、アセットの対応状況 |
| 元のプロジェクトだけ失敗する | プロジェクト内の設定やキャッシュの問題 | Library、Packages、Consoleエラー |
| 新規プロジェクトでは成功する | 元プロジェクトとの相性や依存関係の問題 | 既存パッケージ、レンダーパイプライン、エラー箇所 |
新規プロジェクトで成功するなら、Unity全体を再インストールする必要性は低くなります。逆に、新規プロジェクトでも失敗するなら、現在のプロジェクトだけを疑うより、Unityの環境やアセット側の対応状況を確認した方が近道です。
Unity全体の動作が不安定な場合は、コチラの記事もあわせて確認してみてください。
ここまで切り分ければ、次に何を直すべきかがかなり見えやすくなります。最後に、今回の確認順を整理しておきましょう。
まとめ
Unityでアセットが読み込めない時は、まず「ダウンロードできない」「インポートできない」「インポート後に表示されない」のどれに近いかを確認してみてください。症状を分けるだけで、ネットワーク、ファイルパス、キャッシュ、アセットの破損、互換性など、見るべき場所をかなり絞れます。
最初からUnityを再インストールしたり、設定を大きく変えたりする必要はありません。Consoleのエラーを確認し、再ダウンロード、保存場所の見直し、Libraryの再生成、新規プロジェクトでの再現確認という順番で試すと、安全に原因を切り分けやすくなります。
もし一度で直らなくても、焦らず「どこまでは成功しているか」を見ていけば大丈夫です。アセットが正しく読み込める状態に戻せれば、制作作業にもスムーズに戻れます。
※当サイトはアフィリエイト広告を利用しています。リンクを経由して商品を購入された場合、当サイトに報酬が発生することがあります。
※本記事に記載しているAmazon商品情報（価格、在庫状況、割引、配送条件など）は、執筆時点のAmazon.co.jp上の情報に基づいています。
最新の価格・在庫・配送条件などの詳細は、Amazonの商品ページをご確認ください。