できない.dev

Corepack「Invalid package manager specification」の原因と直し方

Invalid package manager specification は、packageManager を完全な版に書けば直る。
Corepack は ^4 や latest のような範囲やタグを受け付けない。
corepack use yarn@4 で書き直すと、版とハッシュが入る。

公開: 更新:

症状できない · exit 1
yarn --version
Invalid package manager specification in package.json (yarn@^4); expected a semver version
解決後できた · exit 0
yarn --version
4.18.1

2026-11-08 に node:22-bookworm-slim(Corepack 0.36.0 / Node.js 22.23.4) で実際に打って取った出力。検証環境の詳細

要約

Invalid package manager specification は、package.json の packageManager に Corepack が読めない形の版が入っているときに出る。
Node.js 22.23.4 に同梱の Corepack 0.36.0 で "packageManager": "yarn@^4" にして yarn --version を打つと、次の表示で終了コード 1 になった。

Invalid package manager specification in package.json (yarn@^4); expected a semver version

packageManager には、yarn@4.9.2 のように x.y.z まで決まった版を書く。
corepack use に書き直させれば、版とハッシュがそろって入る。

実行例

node:22-bookworm-slim のコンテナで packageManager に yarn@^4・yarn@latest・pnpm@10 を書くと、yarn --version と pnpm --version はどれも終了コード 1 で止まった。
corepack use yarn@4 で完全な版に書き換えると、yarn --version は終了コード 0 で 4.18.1 を返した。

$ node --version
v22.23.4
$ corepack --version
0.36.0
$ corepack enable
$ cat package.json
{
  "name": "app",
  "private": true,
  "packageManager": "yarn@^4"
}
$ yarn --version
Invalid package manager specification in package.json (yarn@^4); expected a semver version
$ echo $?
1
$ grep packageManager package.json
  "packageManager": "yarn@latest"
$ yarn --version
Invalid package manager specification in package.json (yarn@latest); expected a semver version
$ echo $?
1
$ grep packageManager package.json
  "packageManager": "pnpm@10"
$ pnpm --version
Invalid package manager specification in package.json (pnpm@10); expected a semver version
$ echo $?
1
$ grep packageManager package.json
  "packageManager": "yarn"
$ yarn --version
No version specified for yarn in "packageManager" of package.json
$ echo $?
1
$ corepack use yarn@4
Installing yarn@4.18.1 in the project...
 
➤ YN0000: · Yarn 4.18.1
➤ YN0000: ┌ Resolution step
➤ YN0000: └ Completed
➤ YN0000: ┌ Fetch step
➤ YN0000: └ Completed
➤ YN0000: ┌ Link step
➤ YN0000: └ Completed
➤ YN0000: · Done in 0s 50ms
$ echo $?
0
$ grep packageManager package.json
  "packageManager": "yarn@4.18.1+sha512.b2e1e7524f654f2749d32b4ebcb4622473cb5bcbc485df2007e12a154e50162a4d795526768bc5f5b8f81717bfd79deb2472813d86fb5ae2eb551fa9c872b08f"
$ yarn --version
4.18.1
$ echo $?
0
$ grep packageManager package.json
  "packageManager": "yarn@4.9.2"
$ yarn --version
4.9.2
$ echo $?
0

— 2026-11-08 時点の出力

検証環境Node.js 22.23.4 / npm 10.9.9 / Corepack 0.36.0 / 2026-11-08 検証
検証日
実行環境
node:22-bookworm-slim Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 22.23.4
  • npm 10.9.9
  • Corepack 0.36.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. corepack use で書き直させる

corepack use yarn@4

corepack use は指定した範囲から版を 1 つ選び、packageManager をハッシュ付きの完全な版で書き換える。
"packageManager": "pnpm@10" のままの package.json でも corepack use pnpm@10 は通った。
書き換わった値は pnpm@10.34.9+sha512. で始まり、その後の pnpm --version は終了コード 0 で 10.34.9 を返した。

2. 手で書くなら x.y.z まで書く

{
  "packageManager": "yarn@4.9.2"
}

名前と版は @ でつなぐ。
ハッシュは省いても動くが、README は安全のために付けることを強く勧めている。
手で書いた後に corepack use を一度実行すれば、ハッシュも足される。

版を変えたいとき

チームで使う版を上げるときも、package.json を手で ^ 付きに書き換えず、corepack use pnpm@latest のように打つ。
Corepack が最新の版を調べて、完全な版を書き込む。

よくある原因

  1. 範囲やタグを書いた。
    yarn@^4 と yarn@latest は、どちらも同じエラーになった。
    dependencies と同じ感覚で ^ を付けると起きる。
  2. メジャー番号だけを書いた。
    pnpm@10 でも expected a semver version になった。
  3. 版を書いていない。
    "packageManager": "yarn" のときは文言が変わり、No version specified for yarn in "packageManager" of package.json で終了コード 1 になった。

Corepack の README(新しいタブで開く) も、このフィールドには 1 つに決まった版を求めている。
版の範囲を書けるのは devEngines.packageManager.version のほうである。