よくある質問
依存パッケージの導入がメモリ不足で止まる
2026年10月8日

レン
パッケージを入れようとすると、途中でメモリ不足のエラーが出て止まる…

プロクラ
依存関係を解決する処理は、想像以上にメモリを使うんだ。小さいプランでは、これが最初の壁になることが多い。原因は2段階あるよ。
2つの上限
止まる原因は、言語側が自分に課している上限と、サーバー全体の空き容量の2つです。前者は設定を変えれば広がりますが、後者は物理的に足りていません。エラーの文面が似ているので、どちらなのかを先に見分けてください。順番を間違えると、いくら設定を変えても直りません。
- PHP自身に設定された、1プロセスあたりのメモリ上限
- サーバー全体の物理メモリ
- 前者に当たった場合は、設定を変えれば通ることがある
- 後者に当たった場合は、設定を変えても通らない

プロクラ
エラーの文言で見分けられるよ。「Allowed memory size ... exhausted」なら前者。強制終了されて記録も残らないなら、後者の可能性が高い。
前者への対処
- その実行のときだけ、上限を外して実行する
- 設定ファイル自体を変える必要は無い
- Webからの実行には影響しないので、安全
- ただし物理メモリを超えれば、結局落ちる
後者への対処

プロクラ
物理メモリが足りない場合、一時的にしのぐ方法がある。スワップ領域を用意しておくと、遅いけれど処理は完走できることが多いよ。
- スワップを用意する(作業のときだけでもよい)
- 遅くなるが、強制終了は避けられる
- 作業中は、他のサービスを一時的に止める
- それでも通らないなら、別の方法を検討する
本番でビルドしないという選択

プロクラ
そもそも、本番のサーバーで依存解決やビルドをしない構成にする手もある。手元や別の環境で作った結果だけを持ち込めば、本番のメモリを圧迫しない。
- 手元や検証環境で依存を解決し、成果物を持ち込む
- 本番では、実行に必要なものだけを配置する
- 同じ結果を再現できるよう、版を固定する記録を残す
- 本番の負荷が下がるうえ、公開中の停止時間も短くなる

プロクラ
この形にすると、本番サーバーに開発用の道具を入れなくて済むという利点もあるよ。入れるものが減れば、狙われる入口も減る。

レン
設定の上限か、物理メモリか。エラーの文言で見分けるんだね。
作業中だけ資源を空ける

プロクラ
本番サーバーで作業せざるを得ない場合、一時的に他のものを止めて資源を空ける手もある。ただし、その間サイトは止まる点に注意してね。
- アクセスの少ない時間を選ぶ
- 止める前に、戻す手順を確認しておく
- 作業後、止めたものを確実に起動し直す
- 止め忘れが無いか、最後に一覧で確認する
上げるという判断
- 作業のたびに苦労するなら、プランが小さすぎる合図
- 時間課金なら、作業のときだけ上げて戻す運用もできる
- スワップで無理に通すより、素直に上げるほうが早いこともある
- 当サイトの比較表で、同等以上のプランを探せる
この記事の条件で、実際の料金を見る
あわせて読みたい
- よくある質問サーバーの時刻がずれる:確認と直し方ログの時刻が合わない、認証に失敗する、集計がずれる。時刻のずれが引き起こす問題と、時刻同期・タイムゾーンの確認方法を解説します。
- よくある質問支払いが失敗してサーバーが止まった気づかないうちに決済が通らなくなり、サービスが停止する事故の防ぎ方。停止から削除までの流れと、復旧できる期間について解説します。
- よくある質問消したのに空きが増えない:掴まれたままのファイル削除したはずのファイルが容量を占め続ける仕組みと、その確認方法。再起動せずに解放する手順と、そもそも大きく育てない工夫を解説します。
- よくある質問自分が遮断された:Fail2banで締め出されたときの戻り方自動遮断の仕組みに自分が引っかかったときの解除手順。管理画面のコンソールから入る方法と、次回そうならないための除外設定を解説します。
サーバーを触る前に押さえておきたいこと
姉妹サイトの、この記事と相性のいいページです。
- ネットワーク入門
IPアドレス・ポート・DNSの基礎 — prodou.net
- Linuxコマンド入門
ls / cd / grep などを疑似ターミナルで試しながら学べる — prodou.net
- CIDR Calculator
ファイアウォールの許可レンジを計算する — toolkitbox.net