Коди помилок

An error pnpm raises carries a code that starts with ERR_PNPM_. The code is printed with the error message. A script that reacts to a failure should match on the code, because the message may change between releases and the code does not.

The codes are listed in alphabetical order. A code that is not listed here is explained by its own message.

ERR_PNPM_FROZEN_LOCKFILE_WITH_OUTDATED_LOCKFILE#

A frozen install (pnpm install --frozen-lockfile, the default in CI) found that the boot document of pnpm-lock.yaml is not up to date. The boot document records the config dependencies and the pinned package manager. It changes when configDependencies in pnpm-workspace.yaml changes, or when the pnpm version pinned in package.json changes.

Run pnpm install without --frozen-lockfile and commit the updated lockfile.

ERR_PNPM_HOIST_PATTERN_DIFF#

pnpm add, pnpm remove, pnpm update, or an install that selects only some workspace projects found a modules directory that was installed with a different hoistPattern.

Run pnpm install to recreate the modules directory with the new hoistPattern.

ERR_PNPM_IGNORED_BUILDS#

The install skipped the build scripts of one or more dependencies, because allowBuilds does not allow them, and strictDepBuilds is on. The message lists the packages whose scripts were skipped.

Run pnpm approve-builds to allow the builds you trust. To install without failing on skipped builds, set strictDepBuilds to false.

ERR_PNPM_INVALID_NODE_VERSION#

The nodeVersion setting is not an exact semver version, such as 22.22.3.

ERR_PNPM_LOCKFILE_CONFIG_MISMATCH#

A frozen install found that a setting recorded in pnpm-lock.yaml differs from the current configuration. The message names the setting. The lockfile records overrides, patchedDependencies, catalogs, ignoredOptionalDependencies, the checksums of packageExtensions and the pnpmfile, and the resolution settings in its settings block, such as autoInstallPeers and dedupePeers.

Run pnpm install without --frozen-lockfile and commit the updated lockfile.

ERR_PNPM_NODE_LINKER_DIFF#

pnpm add, pnpm remove, pnpm update, or an install that selects only some workspace projects found a modules directory that was installed with a different nodeLinker.

Run pnpm install to recreate the modules directory with the new nodeLinker.

ERR_PNPM_NO_MATCHING_VERSION_INSIDE_WORKSPACE#

Проєкт має залежність робочого простору, якої не існує у робочому просторі.

Наприклад, пакунок foo має bar@1.0.0 у dependencies:

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

Однак у робочому просторі є лише bar@2.0.0, тому pnpm install не вдасться виконати.

Для виправлення цієї помилки слід оновити всі залежності, які використовують протокол робочого простору, щоб вони використовували версії пакунків, присутніх у робочому просторі. Це можна зробити вручну або за допомогою команди pnpm -r update.

ERR_PNPM_NO_OFFLINE_META#

pnpm runs with --offline, and the metadata cache has no entry for a package it has to resolve. The message names the package and the cache file it looked for.

Run the command without --offline once, so pnpm downloads the metadata. --prefer-offline uses the cache when it can and downloads what is missing.

ERR_PNPM_OUTDATED_LOCKFILE#

Ця помилка виникає, коли встановлення не може бути виконано без внесення змін до файлу блокування. Це може статися у середовищі CI, якщо хтось змінив файл package.json у сховищі без запуску pnpm install після цього. Або хтось забув зафіксувати зміни у файлі блокування.

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

ERR_PNPM_PEER_DEP_ISSUES#

With strictPeerDependencies enabled, pnpm install fails if the project has unresolved peer dependencies or the peer dependencies are not matching the wanted ranges. Щоб виправити це, встановіть відсутні прямі залежності.

Ви також можете вибірково ігнорувати ці помилки за допомогою налаштувань peerDependencyRules.ignoreMissing та peerDependencyRules.allowedVersions.

ERR_PNPM_PUBLIC_HOIST_PATTERN_DIFF#

pnpm add, pnpm remove, pnpm update, or an install that selects only some workspace projects found a modules directory that was installed with a different publicHoistPattern.

Run pnpm install to recreate the modules directory with the new publicHoistPattern.

ERR_PNPM_REGISTRY_NAME_MISMATCH#

The registry answered a request for one package with the metadata of a different package. pnpm stops instead of installing the package under a name the registry was not asked about.

Check that the registry configured for the package, or for its scope, is correct. A misconfigured proxy or a registry that serves the wrong document can cause this error.

ERR_PNPM_TARBALL_INTEGRITY#

Ця помилка вказує на те, що tar-файл завантаженого пакунка не збігається з очікуваною контрольною сумою цілісності.

If you use the npm registry (registry.npmjs.org), then this usually means that the integrity in your lockfile is incorrect. Це може статися, якщо у файлі блокування було погано вирішено конфлікти злиття.

Якщо ви використовуєте реєстр, який дозволяє перевизначати наявні версії пакунків, це може означати, що у вашому локальному кеші метаданих зберігається контрольна сума цілісності старішої версії пакунка. У цьому випадку слід виконати pnpm store prune. Ця команда вилучить ваш локальний кеш метаданих. Після цього ви можете повторити команду, яка не спрацювала.

Але також будьте обережні і переконайтеся, що пакунок завантажено з правильної URL-адреси. У повідомленні про помилку має бути виведено URL-адресу.

ERR_PNPM_TASK_CYCLE#

A recursive run's task graph contains a dependency cycle. The error lists the participating tasks as <project>#<script> identifiers.

Remove or change the cycle under tasks. If it is deliberate, set ignoreWorkspaceCycles to true to downgrade the error to a warning and run the cycle's tasks without a guaranteed order.

ERR_PNPM_UNEXPECTED_STORE#

Тека модулів присутня і повʼязана з іншою текою сховища.

Якщо ви змінили теку сховища навмисно, виконайте pnpm install і pnpm перевстановить залежності, використовуючи нову теку сховища.

ERR_PNPM_UNSUPPORTED_ENGINE#

A project's engines.node or engines.pnpm range, or a dependency's engines.node range, does not accept the current version. The message names the package, the wanted range, and the current version.

A project's incompatible engines.pnpm always raises this error. For engines.node, pnpm raises it only with engineStrict enabled. Without it, an incompatible engines.node in the project or a required dependency produces a warning.

To fix this error, switch to a Node.js or pnpm version the package accepts, or turn engineStrict off for an engines.node mismatch.

ERR_PNPM_VIRTUAL_STORE_DIR_MAX_LENGTH_DIFF#

pnpm add, pnpm remove, pnpm update, or an install that selects only some workspace projects found a modules directory that was installed with a different virtualStoreDirMaxLength.

Run pnpm install to recreate the modules directory with the new virtualStoreDirMaxLength.

ERR_PNPM_WORKSPACE_PKG_NOT_FOUND#

A project declares a dependency with the workspace protocol, but no project in the workspace has that name. The message names the project, the dependency, and its specifier.

Check the spelling of the dependency name, and check that the project it refers to is matched by the packages patterns in pnpm-workspace.yaml.