メインコンテンツまでスキップ
Version: Next

エラーコード

ERR_PNPM_UNEXPECTED_STORE​

モジュールディレクトリが存在し、別のストアディレクトリにリンクされています。

ストアディレクトリを意図的に変更したい場合、 pnpm install を実行すると、pnpmは新しいストアを使用して依存関係を再インストールします。

ERR_PNPM_NO_MATCHING_VERSION_INSIDE_WORKSPACE​

ワークスペースに存在しないワークスペース依存関係がプロジェクトに含まれています。

例えば、パッケージ foo の依存関係に bar@1.0.0 があるとします。

{
  "name": "foo",
  "version": "1.0.0",
  "dependencies": {
    "bar": "workspace:1.0.0"
  }
}

しかし、ワークスペースの依存関係にはbar@2.0.0しか存在しないため、pnpm installは失敗するでしょう。

このエラーを修正するには、ワークスペースプロトコルを使用する全ての依存関係が、ワークスペースに存在するパッケージのバージョンを使用できるようにしなければなりません。 手動で修正することもできますし、pnpm -r updateコマンドで修正することもできます。

ERR_PNPM_PEER_DEP_ISSUES​

pnpm install は、プロジェクトに未解決の peer dependencies がある場合、または peer dependencies が要求された範囲に一致しない場合、失敗します。 この問題を解決するには、不足している peer dependencies をインストールします。

また、package.jsonの pnpm.peerDependencyRules.ignoreMissing と pnpm.peerDependencyRules.allowedVersions のフィールドを使用して、これらのエラーを選択的に無視することができます。

ERR_PNPM_OUTDATED_LOCKFILE​

このエラーは、ロックファイルを変更しないとインストールを実行できない場合に発生します。 これはCI環境において、誰かがリポジトリのpackage.jsonファイルを変更した後、pnpm installを実行しない場合に発生する可能性があります。 あるいは、誰かがロックファイルへの変更をコミットするのを忘れたかです。

このエラーを修正するには、pnpm install を実行してから、ロックファイルへの変更をコミットするだけで良いです。

ERR_PNPM_TARBALL_INTEGRITY​

このエラーは、ダウンロードされたパッケージの tarball が整合性チェックサムの期待値と一致しなかったことを示します。

npm レジストリ(registry.npmjs.org) を使用している場合、これはおそらくロックファイルの整合性が正しくないことを意味します。 これは、ロックファイルのマージ競合を正常に解決しなかった場合に発生する可能性があります。

パッケージの既存のバージョンを上書きできるレジストリを使用している場合、あなたのローカルのメタデータキャッシュに、パッケージの古いバージョンの整合性チェックサムがキャッシュされているのかもしれません。 この場合、 pnpm store prune を実行する必要があります。 このコマンドは、あなたのローカルのメタデータキャッシュを削除します。 その後、失敗したコマンドを再試行してください。

しかし、パッケージが正しいURLからダウンロードされていることも注意して確認してください。 URLはエラーメッセージに表示されています。

ERR_PNPM_MISMATCHED_RELEASE_CHANNEL​

The config field use-node-version defines a release channel different from version suffix.

例:

  • rc/20.0.0 defines an rc channel but the version is that of a stable release.
  • release/20.0.0-rc.0 defines a release channel but the version is that of an RC release.

To fix this error, either remove the release channel prefix or correct the version suffix.

Note that it is not allowed to specify node versions like lts/Jod. The correct syntax for stable release is strictly X.Y.Z or release/X.Y.Z.

ERR_PNPM_INVALID_NODE_VERSION​

The value of config field use-node-version has an invalid syntax.

Below are the valid forms of use-node-version:

  • Stable release:
    • X.Y.Z (X, Y, Z are integers)
    • release/X.Y.Z (X, Y, Z are integers)
  • RC release:
    • X.Y.Z-rc.W (X, Y, Z, W are integers)
    • rc/X.Y.Z-rc.W (X, Y, Z, W are integers)