ビルド中のJavaメモリ不足で、Androidの保存データが一時的に空ファイル化した話
個人開発中のスマホゲーム「MineEmpire3D」(Unity製)で、修正版APKのビルド中にJavaのメモリ不足が発生し、その対応中に確保していたはずのAndroid側保存データ6件が、後の端末再起動で一時的に空ファイルになっていた記録です。2026年11月4日の実際の開発記録(devlog)に基づいており、架空の体験や感想は含んでいません。
ビルド中にJavaのメモリ不足が発生し、データ保護を優先した
修正版APKのビルドを進めていたところ、以下のエラーが発生しました。
There is insufficient memory for the Java Runtime Environment to continue.
ページング ファイルが小さすぎるため、この操作を完了できません。
OSのメモリ状況とJavaのログを確認し、対象のAVD(Android仮想デバイス)を正常終了させることで、仮想メモリの空きを約1.2GBから4.4GBまで増やしました。しかしUnity Editorの実応答は30秒でタイムアウトし、Computer Useスキルでの初期化も失敗しました。
この時点では問題を解決できなかったため、二重にビルドを走らせることや、推測でシステム設定を変更することは避け、Unity側に表示されているダイアログの内容を確認してもらうようユーザーに依頼しました。エラーの発生箇所と原文のログはそのまま保管しています。所要時間は約8分でした。
この待機中に、低メモリのAVDを一時的に起動し、Android側にあった元データ6件を復元しました。全件についてサイズとSHAハッシュ、通常表示を照合したうえでAVDを再終了し、この時点では元データの復元漏れはない状態でした。
メモリを確保して再試行し、修正版APKのビルドが成功
Build failureを示す画像をユーザーに確認してもらい、OKの応答を得たうえで、AVDを停止して空きメモリを確保し、Unity Editorを再起動せずに再試行しました。
There is insufficient memory for the Java Runtime Environment to continue.
Editorがready状態に復帰した後、修正版APKのビルドは52秒で成功しました。ページファイルの設定、ACL、他のアプリケーションはいずれも変更していません。所要時間は約5分(ユーザーの応答待ちを除く)でした。
再起動後、Android側の保存データ6件が空ファイルに
復元直後の照合では一致していたAndroid側の保存データでしたが、その後の端末再起動を経て確認したところ、6件すべてが空ファイルになっていることが判明しました。
過去2箇所にあった元データのコピーについて、SolとLunaがSHAハッシュを照合しました。空ファイルの状態はそのまま保管し、既知の元データ6件を復元したうえで同期を行い、再起動後・起動後の両方のタイミングで再度照合しました。
最終的に元データ6件のサイズとSHAハッシュの一致を確認できましたが、空ファイル化そのものの原因は特定できていません。この経験から、「復元直後の一致だけでは永続化が完了したとは扱わない」という基準に訂正し、新しく生成された空のmanifestファイルを復元元として使わない、という手順を記録に残しました。所要時間は約10分でした。
まとめ:発生したエラーと対応
| 作業 | 起きたこと | 対応 | 結果 | 所要時間 |
|---|---|---|---|---|
| APKビルド中のメモリ不足 | There is insufficient memory for the Java Runtime Environment to continue./ページングファイル不足 |
AVD終了で仮想メモリを1.2GB→4.4GBに確保。二重ビルドや推測対応は避けてユーザーに画面確認を依頼 | この時点では未解決。Android元データ6件は復元・照合済みで保護 | 約8分 |
| ビルドの再試行 | 同エラー再掲(メモリ不足によるビルド失敗) | AVD停止で空きメモリ確保後、Editor再起動なしで再試行 | 修正版APKが52秒でビルド成功 | 約5分(応答待ち除く) |
| 再起動後のデータ空ファイル化 | 復元直後は一致していた保存データ6件が、再起動後に全件空ファイルに | 既知の元データ6件を再復元し、sync後に再起動後・起動後で再照合 | サイズ・SHA一致を確認。原因は未確定のまま「直後一致だけでは完了扱いしない」基準に訂正 | 約10分 |
Javaのメモリ不足自体はAVD終了による空きメモリ確保で解消できましたが、その対応の最中に発生したAndroid側保存データの空ファイル化は、原因を特定できないまま「復元して再照合する」という対応にとどまっています。復元直後の一致だけを完了の根拠にしない、という手順上の訂正を今回の記録として残しました。
この記事は運営者の実際の開発記録をもとに、AIの支援を受けて作成しています。