본문으로 건너뛰기
버전: Next

에러 코드

ERR_PNPM_UNEXPECTED_STORE

모듈 디렉토리가 있고 다른 저장소 디렉토리에 연결되어 있습니다.

여러분이 스토어 디렉토리를 의도적으로 변경한다면, pnpm install 을 실행하여 pnpm이 새로운 스토어를 통해 의존성을 재설치합니다.

ERR_PNPM_NO_MATCHING_VERSION_INSIDE_WORKSPACE

프로젝트가 워크스페이스에서 존재하지 않는 워크스페이스 의존성을 갖고 있습니다.

예를 들어, foo 패키지는 dependencies 에서 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 이 실패합니다. 이 문제를 해결하려면 누락된 피어 의존성을 설치하십시오.

package.jsonpnpm.peerDependencyRules.ignoreMissingpnpm.peerDependencyRules.allowedVersions 필드를 사용하여 이러한 오류를 선택적으로 무시할 수도 있습니다.

ERR_PNPM_OUTDATED_LOCKFILE

This error happens when installation cannot be performed without changes to the lockfile. This might happen in a CI environment if someone has changed a package.json file in the repository without running pnpm install afterwards. Or someone forgot to commit the changes to the lockfile.

To fix this error, just run pnpm install and commit the changes to the lockfile.

ERR_PNPM_TARBALL_INTEGRITY

This error indicates that the downloaded package's tarball did not match the expected integrity checksum.

If you use the npm registry (registry.npmjs.org), then this probably means that the integrity in your lockfile is incorrect. This might happen if a lockfile had badly resolved merge conflicts.

If you use a registry that allows to override existing versions of a package, then it might mean that in your local metadata cache you have the integrity checksum of an older version of the package. In this case, you should run pnpm store prune. This command will remove your local metadata cache. Then you can retry the command that failed.

But also be careful and verify that the package is downloaded from the right URL. The URL should be printed in the error message.

ERR_PNPM_MISMATCHED_RELEASE_CHANNEL

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

For example:

  • 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.

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)