できない.dev

pnpm「ERR_PNPM_UNRECOGNIZED_WORKSPACE_SETTINGS」の原因と直し方

ERR_PNPM_UNRECOGNIZED_WORKSPACE_SETTINGS は、pnpm-workspace.yaml の設定名の綴りを直すか行を消せば直る。
pnpm 12 は、固定した版で動くプロジェクトの知らない設定を警告ではなくエラーにした。

公開:

要約

pnpm 12 で動くプロジェクトで pnpm install を打つと、何も入れずに終了コード 1 で止まることがある。

Error: ERR_PNPM_UNRECOGNIZED_WORKSPACE_SETTINGS

ERR_PNPM_UNRECOGNIZED_WORKSPACE_SETTINGS は、pnpm-workspace.yaml に今の pnpm が知らない設定があるときのエラーである。
pnpm 12 から、package.json の packageManager で固定した版を動いている pnpm が満たすとき、この検査で install が止まる。
固定が無いときは警告だけで進む。
別の版を固定していると、pnpm 12 はその版に切り替えて動かす。
エラーが挙げた設定の綴りを直すか、その行を消せば通る。

解決策

1. 設定の綴りを直す

エラーの did you mean に出た名前に書き直す。

# pnpm-workspace.yaml
minimumReleaseAge: 0

直したあとに pnpm install を打ち直せば、終了コード 0 で通る。

2. 12 で無くなった設定を消す

(a pnpm v11 setting) と出た設定は、12 では使えない。
pnpm 11 からの移行ガイド(新しいタブで開く)は、12 が confirmModulesPurge を拒むと書き、設定を消すよう案内している。
その行を pnpm-workspace.yaml から消してから、pnpm install を打ち直す。

3. pnpm config で設定の値を確かめる

12.0.0 のリリースノート(新しいタブで開く)によると、pnpm config のサブコマンドはこの検査で失敗しない。
install が止まったプロジェクトでも、設定が読まれているかを確かめられる。

pnpm config get minimumReleaseAge

綴りを直す前に打つと、値は undefined と出る。
直したあとは書いた値が返る。

4. 12 に上げる前に 11 の警告を読む

11 の pnpm install は、知らない設定を次の警告で知らせていた。

[WARN] The following settings in pnpm-workspace.yaml are not recognized by this version of pnpm and were ignored

固定を 12 に替える前にこの警告を消しておけば、上げた直後に止まらない。
confirmModulesPurge のように 11 が知っている設定は警告に出ないので、pnpm-workspace.yaml にあれば先に消す。

よくある原因

  1. 設定名を打ち間違えている。
    エラーには知らない設定の名前と、近い名前の候補(did you mean "minimumReleaseAge"?)が出る。
  2. 固定した版を 12 に上げた。
    11 は同じ打ち間違いを警告して無視し、install は 0 で終わっていた。
    設定は効いていなかったが、固定を pnpm@12 に書き換えた時点で同じ行がエラーに変わる。
  3. 12 で無くなった設定が残っている。
    11 の confirmModulesPurge は、11 では警告も出ない。
    12 では (a pnpm v11 setting) と添えられて、同じエラーで止まる。