11# pnpm v10.27 メモリリーク問題の調査と解決
22
33** 日付:** 2026-01-02
4+
45** 根本原因:** pnpm v10.27.0 のグローバルストア構造変更
6+
57** 状態:** ✅ 解決
68
79## 問題の症状
@@ -53,17 +55,30 @@ NODE_OPTIONS=--max-old-space-size=8192 pnpm dev # 失敗(4096 でも失敗)
5355- ローカルの ` node_modules ` キャッシュが古い構造を参照して不整合
5456- Vite + SvelteKit の開発サーバ起動時に、watch モード初期化でメモリを過剰消費
5557
56- ## 解決方法
58+ ## 解決方法(v10.28.0 へのアップグレード)
59+
60+ ** 状態:** ✅ 2026-01-18 に検証完了
61+
62+ pnpm v10.28.0 で v10.27.0 の問題が修正されました。
63+
64+ ### v10.28.0 での修正内容
5765
58- ** pnpm をダウングレード:v10.27.0 → v10.26.2**
66+ [ pnpm v10.28.0 Release Notes] ( https://github.com/pnpm/pnpm/releases/tag/v10.28.0 ) のパッチ ` #10411 ` にて以下が修正されました:
67+
68+ > Do not add a symlink to the project into the store's project registry if the store is in a subdirectory of the project
69+
70+ ** 影響:** Docker + OrbStack 環境でのストア位置管理の問題を解決
71+
72+ ### アップグレード手順
5973
6074[ package.json] ( ../../../package.json ) の devDependencies を変更:
6175
6276``` json
6377{
6478 "devDependencies" : {
65- "pnpm" : " 10.26.2"
66- }
79+ "pnpm" : " 10.28.0"
80+ },
81+ "packageManager" : " pnpm@10.28.0"
6782}
6883```
6984
@@ -73,7 +88,13 @@ NODE_OPTIONS=--max-old-space-size=8192 pnpm dev # 失敗(4096 でも失敗)
7388pnpm install --no-frozen-lockfile
7489```
7590
76- ## 結果
91+ ### 動作確認結果
92+
93+ - ✅ ` pnpm dev ` - 正常に起動、メモリリークなし
94+ - ✅ ` pnpm test:unit ` - 正常に実行、watch モード安定動作
95+ - ✅ ` pnpm build ` - 正常にビルド完了
96+
97+ ## 結果(従来の方法)
7798
7899✅ ` pnpm dev ` が正常に起動
79100
@@ -94,37 +115,6 @@ pnpm install --no-frozen-lockfile
94115
95116これらが相互作用して、ローカル環境でメモリ問題を引き起こした可能性がある。
96117
97- ### 根本原因の確実性と環境固有性
98-
99- ** 確実な事実:**
100-
101- - pnpm v10.27.0 へのアップデート直後に問題が発生
102- - v10.26.2 へのダウングレードで即座に解決
103- - v10.27.0 は 2025年12月末リリース
104-
105- ** 推測される部分(高確度だが確定ではない):**
106-
107- - Vite の Pre-bundling キャッシュ無効化メカニズムが影響
108- - Watch モード中の累積メモリ消費
109- - ** 環境固有の問題である可能性が高い** ⚠️
110-
111- ** 環境固有である理由:**
112-
113- - GitHub issues に同様の報告がない(pnpm 10.27.0 は pnpm の最新版)
114- - このプロジェクト特有の設定の可能性:
115- - Docker コンテナ環境 + OrbStack での実行
116- - ` compose.yaml ` での ` volumes: cached ` 設定
117- - ホスト macOS との ファイルシステム監視の相互作用
118- - ** 「pnpm 10.27.0 + Docker/OrbStack + Vite watch」の組み合わせに限定される可能性**
119-
120- つまり、pnpm 10.27.0 自体が不具合をもたらしたというより、** このプロジェクトの開発環境における相互作用が問題を引き起こした** 可能性が高い。
121-
122- ### 将来への対応
123-
124- - pnpm 10.27.1 以降で修正される可能性は低い(報告がないため)
125- - 次のメジャーアップデートまで v10.26.2 を維持することを推奨
126- - または、Docker 内での watch 設定やボリュームマウント設定を最適化してから検証する
127-
128118### 参考リンク
129119
130120- [ pnpm v10.27.0 Release Notes] ( https://github.com/pnpm/pnpm/releases/tag/v10.27.0 )
0 commit comments