Skip to content
Latchkey
Node.js & npm

npm, yarn, and pnpm failures in CI - solved.

Resolve Node.js build failures in CI/CD: npm install errors, lockfile drift, peer dependency conflicts, registry timeouts, and out-of-memory builds. Practical fixes for npm, yarn, and pnpm.

Install & dependency resolution

ERESOLVE, peer deps, lockfile mismatches.

"backstage-cli: command not found"Fix "backstage-cli: command not found" in CI - the @backstage/cli binary is missing because dependencies were… "Cannot find module @backstage/plugin-"Fix Backstage "Error: Cannot find module @backstage/plugin-..." in CI - a plugin package is not installed or… "requires Node.js version"Fix Backstage "The engine node is incompatible" / requires Node.js version error in CI - the runner Node does… better-sqlite3 node-gyp failsFix Backstage "yarn install" failing on better-sqlite3 node-gyp rebuild in CI - the native module compiles fr… yarn workspaces build failsFix Backstage yarn workspaces build failures in CI - a workspace package fails to resolve internal packages o… "failed to resolve" (bun install)Fix Bun "error: Failed to install" / "failed to resolve" in CI - Bun could not resolve a dependency version a… "incorrect peer dependency"Fix Bun peer dependency issues in CI - Bun reports an incorrect or unmet peer dependency, and the installed p… "lockfile had changes, but lockfile is frozen"Fix Bun "error: lockfile had changes, but lockfile is frozen" in CI - with --frozen-lockfile the resolved dep… bun.lockb binary conflictsFix bun.lockb binary lockfile problems in CI - the binary lockfile produces opaque diffs and merge conflicts… Bun install cache corruptFix Bun install cache problems in CI - a corrupt or stale global install cache makes bun install fail or reso… Bun vs npm node_modulesFix Bun vs npm node_modules mismatches in CI - a node_modules tree installed by npm/yarn/pnpm is not what Bun… Bun workspaces not resolvingFix Bun workspaces resolution in CI - a monorepo workspace package is not found because the workspaces glob,… "configured to use yarn"Fix the Corepack "this project is configured to use yarn" error in CI by running the package manager named in… "error: Module not found"Fix Deno "error: Module not found ..." in CI - Deno resolved an import specifier to a location that does not… "lock file ... integrity"Fix Deno lockfile errors in CI - "error: Failed reading lock file" or a deno.lock integrity mismatch when the… "Import assertion type ... not supported"Fix Deno "error: Import assertion type ... not supported" in CI - a JSON or other import used an assertion/at… "not prefixed with / or ./ or ../"Fix Deno "error: Relative import path ... not prefixed with / or ./ or ../" in CI - a bare specifier was used… "Could not find version ... that matches"Fix Deno "error: Could not find version of ... that matches" in CI - a jsr: specifier or constraint has no pu… "npm package ... not found"Fix Deno "error: npm package ... not found" in CI - an npm: specifier named a package or version the npm regi… "husky: command not found"Fix husky failing in CI - "husky: command not found" or a failing prepare script - when Git hooks try to inst… "@swc/core platform binary missing"Fix "Failed to load native binding" / "Cannot find module '@swc/core-linux-x64-gnu'" in CI - the @swc/core pl… "Bus error (core dumped) napi addon"Fix "Bus error (core dumped)" from a native N-API addon in CI - an ABI mismatch or memory-mapping fault crash… "Cannot find module fsevents (optional)"Explain "Cannot find module 'fsevents'" in CI - fsevents is a macOS-only optional dependency and is correctly… "Cannot find lightningcss.linux-x64-gnu.node"Fix "Cannot find module 'lightningcss.linux-x64-gnu.node'" in CI - the platform-specific optional binary for… "ERR_INTERNAL_ASSERTION (node bug)"Fix Node "ERR_INTERNAL_ASSERTION: This is caused by either a bug in Node.js or incorrect usage of Node.js int… "ERR_INVALID_THIS (undici fetch)"Fix Node "TypeError [ERR_INVALID_THIS]: Value of this must be of type Headers" in CI - usually a global fetch… "ERR_WORKER_OUT_OF_MEMORY"Fix Node "ERR_WORKER_OUT_OF_MEMORY: Worker terminated due to reaching memory limit" in CI - a worker thread e… "prebuilt binary not found for musl (alpine)"Fix "prebuilt binary not found for ... musl" on Alpine in CI - a native package ships glibc prebuilds only, s… "gyp ERR! find Python"Fix node-gyp "gyp ERR! find Python ... Could not find any Python installation to use" in CI - the native buil… "No Xcode or CLT version detected"Fix node-gyp "No Xcode or CLT version detected!" on macOS CI - install the Command Line Tools, or skip the na… "gyp ERR! not found: make"Fix node-gyp "gyp ERR! stack Error: not found: make" in CI - the C/C++ build toolchain (make, gcc) is missing… "node-pre-gyp install --fallback-to-build failed"Fix node-pre-gyp "install --fallback-to-build" failure in CI - the prebuilt binary download failed and the so… "Cannot find module"Fix Node.js "Error: Cannot find module" in CI - a require that resolves to nothing because the package is mis… "Could not load the sharp module"Fix "Could not load the sharp module using the <platform> runtime" in CI - sharp's platform-specific binary i… "patch-package failed to apply"Fix "Failed to apply patch" from patch-package in CI - a patch no longer matches the installed package versio… "prebuild-install fallback to source"Fix prebuild-install falling back to a node-gyp source build in CI - no prebuilt binary matched the platform/… postinstall skippedFix breakage from npm --ignore-scripts in CI - packages that rely on postinstall (native builds, binary downl… "--workspace" no matchFix npm --workspace / --workspaces commands that match no package in CI - a filter naming a directory instead… "always-auth" ignoredFix npm auth failures tied to the deprecated always-auth .npmrc key in CI - newer npm ignores always-auth, so… "404 Not Found scoped package"Fix npm "404 Not Found" for a scoped package in CI - the scope is not mapped to the private registry, so npm… "--omit=dev" missing toolFix builds that break after `npm ci --omit=dev` in CI - a compiler or bundler needed at build time lives in d… "Cannot read properties of null"Fix npm "Cannot read properties of null" engine errors in CI caused by a corrupted lockfile or cache, by clea… "npm warn deprecated" fails CIFix a CI install that fails on deprecation/audit findings - an audit-level or strict warning policy turns npm… "npm ERR! code EBADPLATFORM"Fix npm "EBADPLATFORM Unsupported platform" in CI - a package (or its optional binary) declares an os/cpu tha… "EEXIST symlink (concurrent install)"Fix npm "EEXIST: file already exists, symlink" during install in CI - two installs raced to create the same b… "ENOTEMPTY rename during install"Fix npm "ENOTEMPTY: directory not empty, rename" during install in CI - two installs or a stale partial direc… "peer dependency tree could not be resolved"Fix npm 7+ "ERESOLVE unable to resolve dependency tree" from a conflicting peer dependency in CI - strict pee… "code ETARGET No matching version found"Fix npm "code ETARGET No matching version found for X@Y" in CI - the requested version range does not exist,… "npm ERR! code EUNSUPPORTEDPROTOCOL"Fix npm "EUNSUPPORTEDPROTOCOL" in CI - a dependency uses a URL scheme (link:, portal:, catalog:, patch:) the… lockfileVersion mismatchFix npm errors from a package-lock.json written by a newer npm than CI runs - an unexpected lockfileVersion t… "Invalid package name"Fix npm "Invalid package name" and "Invalid Version" errors in CI - a package.json whose name or version does… "No workspaces found"Fix npm "No workspaces found" or "workspace <name> not found" in CI - a misdeclared workspaces glob, a missin… "notarget No matching version"Fix npm "notarget No matching version found for <pkg>@<range>" in CI - distinct from ETARGET, this is the res… npm overrides ignoredFix npm `overrides` that seem ignored in CI - a stale lockfile, an old npm version, or a malformed overrides… overrides vs resolutionsFix a transitive version pin that stops working after switching package managers in CI - npm reads "overrides… "npm WARN peer dep missing"Fix npm "peer dep missing" warnings in CI by installing the unmet peer dependency at a compatible version so… "Tracker idealTree already exists"Fix npm "Tracker idealTree already exists" in CI - caused by two npm processes installing at once or a stale… "Unsupported URL Type 'workspace:'"Fix npm "Unsupported URL Type 'workspace:'" in CI - a package.json uses the pnpm/yarn workspace: protocol tha… "package-lock.json … in sync"Fix "npm ci can only install with an existing package-lock.json … in sync with package.json" in CI - caused b… "npm ci can only install with a lockfile"Fix "npm ci can only install with an existing package-lock.json" by committing a lockfile, since npm ci refus… npm dedupe no effectFix npm dedupe not reducing duplicate dependencies in CI - npm ci installing strictly from a non-deduped lock… "EACCES: permission denied"Fix npm "EACCES: permission denied" errors on ~/.npm or node_modules in CI and Docker - caused by files owned… "npm ERR! code EACCES"Fix "npm ERR! code EACCES permission denied" in CI by correcting ownership of the npm cache and project direc… "Unsupported engine"Fix npm EBADENGINE / "Unsupported engine" warnings and errors in CI - when a package requires a Node version… "npm WARN EBADENGINE"Fix "npm WARN EBADENGINE unsupported engine" in CI by matching the runner Node version to the engines field y… EBADENGINE one packageFix a specific-package npm EBADENGINE in CI - when one dependency declares a narrow engines.node range (e.g.… "npm error code EEXIST"Fix npm EEXIST "File already exists" in CI - npm could not create a bin symlink or directory because a file i… "npm error code EINTEGRITY"Fix npm EINTEGRITY "integrity checksum failed when using sha512" in CI - a tarball whose hash does not match… "npm ERR! code EINTEGRITY"Fix npm EINTEGRITY sha512 checksum mismatches in CI caused by stale lockfile hashes, a corrupted cache, or a… "npm error code EJSONPARSE"Fix npm EJSONPARSE "Failed to parse JSON data" in CI - an invalid package.json (trailing comma, comment, or m… "npm ERR! code ELIFECYCLE"Fix "npm ERR! code ELIFECYCLE" during install in CI by finding the lifecycle script that exited non-zero and… "Errors … in your package-lock.json"Fix npm lockfile verification errors in CI - "Errors were found in your package-lock.json, run npm install to… engine-strict install failsUnderstand npm engine-strict - why it turns EBADENGINE warnings into hard install failures in CI, and how to… "npm ERR! code ENOENT package.json"Fix "npm ERR! code ENOENT ... package.json" in CI when npm runs in a directory that has no package.json, usua… "npm error code ENOLOCAL"Fix npm ENOLOCAL in CI - npm treated a dependency spec as a local path and could not find a package there. Us… "EPERM: operation not permitted"Fix npm "EPERM: operation not permitted" in CI/Docker - npm could not unlink or rename a file because it is l… ERESOLVE peer conflictFix npm ERESOLVE "unable to resolve dependency tree" peer dependency conflicts in CI - properly, without blin… "ERESOLVE unable to resolve dependency tree"Fix the npm ERESOLVE "unable to resolve dependency tree" error in CI by resolving the real peer version confl… ERESOLVE @types/reactFix npm ERESOLVE conflicts driven by @types/react / @types/react-dom version mismatches in CI - align the typ… "npm error code EUSAGE"Fix npm EUSAGE in CI - npm rejected the command because of an unknown flag, wrong arguments, or a typo. Read… global legacy-peer-depsFix surprising installs from a global legacy-peer-deps setting - a user/global .npmrc silently ignoring peer… "ELOOP … symbolic links"Fix npm link "ELOOP: too many symbolic links encountered" in CI - a self-referential or circular symlink crea… "lockfileVersion mismatch"Fix npm lockfileVersion mismatches in CI by aligning the npm version that reads the lockfile with the version… "gyp ERR! build error"Fix "gyp ERR! build error" / node-gyp build failures in CI by installing the C/C++ toolchain and Python that… optional dep skipped for platformFix npm installs where a platform-specific optional dependency is skipped in CI, then a build or runtime step… "Permission denied" on binFix a package bin failing to run in CI - "Permission denied" because the bin file lost its executable bit, of… "npm pkg" command errorFix npm pkg errors in CI - `npm pkg set`/`get`/`fix` failing with EUSAGE or a JSON path error when scripting… postinstall blocked by policyFix breakage when an org-wide ignore-scripts policy blocks postinstall in CI - packages that download binarie… prepare/prepublishOnly failsFix npm prepare and prepublishOnly lifecycle failures in CI - a build or check that runs on install/publish a… "working directory not clean"Fix npm version failing in CI - "Git working directory not clean" or git tag creation errors when npm version… "engines" unmetFix your own package.json "engines" (node/npm) gate failing in CI - engine-strict turning your declared node/… pnpm non-hoisted moduleFix pnpm "Cannot find module" in CI for a package that relies on flat node_modules - pnpm’s strict non-flat l… "EACCES" (pnpm store)Fix pnpm "EACCES: permission denied" on the content-addressable store or node_modules in CI/Docker - a store… "pnpm ELIFECYCLE prepare failed"Fix pnpm "ELIFECYCLE ... prepare: ... Exit status 1" in CI - a prepare lifecycle script (often for a git depe… "ERR_PNPM_LINKING_FAILED"Fix pnpm "ERR_PNPM_LINKING_FAILED" in CI - pnpm could not hard-link or symlink packages from the store into n… "Cannot proceed with the frozen installation"Fix pnpm "ERR_PNPM_LOCKFILE_CONFIG_MISMATCH Cannot proceed with the frozen installation" in CI - install sett… "No matching version found"Fix pnpm "ERR_PNPM_NO_MATCHING_VERSION No matching version found for X" in CI - the registry has no release o… "Cannot install with frozen-lockfile"Fix pnpm "ERR_PNPM_OUTDATED_LOCKFILE: Cannot install with frozen-lockfile because pnpm-lock.yaml is not up to… "ERR_PNPM_PEER_DEP_ISSUES"Fix ERR_PNPM_PEER_DEP_ISSUES in CI - pnpm with strict-peer-dependencies treats unmet or conflicting peer depe… "Unmet peer dependencies"Fix pnpm "ERR_PNPM_PEER_DEP_ISSUES Unmet peer dependencies" in CI - pnpm defaults to strict-peer-dependencies… "ERR_PNPM_TARBALL_EXTRACT"Fix pnpm "ERR_PNPM_TARBALL_EXTRACT" in CI - pnpm could not extract a downloaded package tarball because the d… "ERR_PNPM_UNEXPECTED_STORE"Fix pnpm "ERR_PNPM_UNEXPECTED_STORE: Unexpected store location" in CI - node_modules was created against a di… "workspace:" protocol failsFix pnpm "workspace:" protocol resolution failures in CI - a package referenced as workspace:* is not matched… pnpm deploy incompleteFix pnpm deploy producing an incomplete deployment directory in CI - a workspace package missing built output… "ERR_PNPM_LINKING_FAILED"Fix pnpm ERR_PNPM_LINKING_FAILED in CI/Docker - pnpm could not hard-link/clone from its store into node_modul… "ERR_PNPM_LOCKFILE_BREAKING_CHANGE"Fix pnpm ERR_PNPM_LOCKFILE_BREAKING_CHANGE in CI - the committed pnpm-lock.yaml uses a format version the ins… "ERR_PNPM_LOCKFILE_CONFIG_MISMATCH"Fix ERR_PNPM_LOCKFILE_CONFIG_MISMATCH in CI when the lockfile was built with different settings than the curr… "ERR_PNPM_NO_MATCHING_VERSION"Fix pnpm ERR_PNPM_NO_MATCHING_VERSION "No matching version found for <pkg>@<range>" in CI - a range no publis… "ERR_PNPM_NO_MATCHING_VERSION"Fix ERR_PNPM_NO_MATCHING_VERSION in CI when a requested version range matches nothing in the registry, by cor… ERR_PNPM_OUTDATED_LOCKFILEFix pnpm ERR_PNPM_OUTDATED_LOCKFILE "Cannot install with frozen-lockfile because pnpm-lock.yaml is not up to… "ERR_PNPM_OUTDATED_LOCKFILE"Fix ERR_PNPM_OUTDATED_LOCKFILE in CI by regenerating and committing pnpm-lock.yaml, since pnpm install --froz… "ERR_PNPM_PEER_DEP_ISSUES"Fix pnpm ERR_PNPM_PEER_DEP_ISSUES in CI - strict-peer-dependencies turning missing/mismatched peers into a ha… ERR_PNPM_PEER_DEP_ISSUESFix pnpm ERR_PNPM_PEER_DEP_ISSUES "Unmet peer dependencies" in CI - pnpm’s strict peer checking failing the i… "ERR_PNPM_PEER_DEP_ISSUES"Fix ERR_PNPM_PEER_DEP_ISSUES in CI by satisfying unmet peer dependencies, since pnpm with strict-peer-depende… "ERR_PNPM_TARBALL_INTEGRITY"Fix pnpm ERR_PNPM_TARBALL_INTEGRITY in CI - a downloaded tarball whose checksum does not match the lockfile,… pnpm store dir mismatchFix pnpm ERR_PNPM_UNEXPECTED_VIRTUAL_STORE_DIR / modules-dir mismatch in CI - a cached node_modules built for… ERR_PNPM_UNSUPPORTED_ENGINEFix pnpm ERR_PNPM_UNSUPPORTED_ENGINE "Unsupported engine" in CI - a package (or pnpm itself) requiring a diff… "Drift detected"Fix Prisma "Drift detected: Your database schema is not in sync with your migration history" in CI - the data… "Error validating" schema.prismaFix "Error validating" in schema.prisma in CI - Prisma parses and validates the schema before any command run… "migrate dev" is not for CIFix Prisma migrate hanging or failing in CI because `migrate dev` was used - it is interactive and may reset.… "P3005: database schema is not empty"Fix Prisma "P3005: The database schema is not empty" in CI - migrate deploy hit an existing schema with no mi… "P3009: failed migrations in the target database"Fix Prisma "P3009: migrate found failed migrations in the target database" in CI - a prior migration is marke… "prisma db push" failsFix "prisma db push" failures in CI - the command force-syncs schema.prisma to the database and can warn abou… "prisma db seed" failedFix "prisma db seed" failing in CI - the seed script errored or the seed command is not configured. Fix the s… "relation ... does not exist"Fix Postgres "relation \"X\" does not exist" through Prisma in CI - the tests query a table before migrations… "Could not find a schema.prisma file"Fix "Could not find a schema.prisma file" in CI - the schema lives at a non-default path or split across mult… "lockfile needs to be updated"Fix yarn install --frozen-lockfile failures in CI when the lockfile is out of date, by regenerating and commi… "unexpected error occurred: ENOENT"Fix yarn "An unexpected error occurred ... ENOENT" in CI by pointing yarn at the directory that actually cont… "Cannot find the node_modules state file"Fix Yarn "Cannot find the node_modules state file" in CI - the .yarn-state.yml that tracks the node-modules l… "Couldn't find any versions"Fix yarn "Couldn't find any versions for <pkg> that matches <range>" in CI - a version range no published rel… "Couldn't find package"Fix yarn "Couldn't find package X required by Y" in CI - a dependency or version that yarn cannot resolve fro… "Integrity check failed"Fix yarn "Integrity check failed for …" / checksum mismatch in CI - a fetched package whose hash does not mat… "Integrity check failed"Fix yarn integrity check failures in CI by clearing the yarn cache and reconciling yarn.lock when an installe… "isn't specified in a manifest"Fix Yarn "This module isn't specified in a manifest" in CI - code imports a package not declared in the works… "lockfile needs to be updated"Fix yarn "Your lockfile needs to be updated" under --frozen-lockfile / --immutable in CI - package.json chang… Yarn immutable-cache errorFix Yarn Berry CI failures - YN0028/immutable-cache or a missing offline mirror cache - when --immutable expe… Yarn plugin not foundFix Yarn Berry "Couldn’t find a plugin" / plugin import errors in CI - a .yarnrc.yml plugins entry pointing a… "lockfile would have been modified"Fix Yarn Berry "YN0028: The lockfile would have been modified by this install, which is explicitly forbidden"… Yarn enableScripts falseFix Yarn Berry leaving native packages half-installed in CI - enableScripts:false (or a per-package setting)… nodeLinker mismatchFix Yarn Berry nodeLinker errors in CI - a project configured for PnP failing under node-modules tooling, or… "Yarn PnP strict: cannot find module"Fix Yarn Berry Plug-n-Play strict mode "Your application tried to access X, but it is not declared in your de… zero-installs but no committed cacheFix Yarn Berry zero-installs failures in CI - the workflow assumes committed .yarn/cache and .pnp.cjs, but th… "lockfile needs to be updated"Fix Yarn 1 "Your lockfile needs to be updated, but yarn was run with --frozen-lockfile" in CI - yarn.lock is… "Couldn't find package ... on the registry"Fix Yarn 1 "Couldn't find package X required by Y on the npm registry" in CI - a workspace dependency is not… "Integrity check failed"Fix Yarn 1 "Integrity check failed" / "incorrect integrity when fetching" in CI - the installed node_modules…

Registry & network

Timeouts, 5xx, auth, and proxy errors.

e2e "connection refused"Fix Backstage end-to-end (Playwright) test failures in CI - the test starts before the backend is serving, so… "401 Unauthorized" (bun install)Fix Bun install 401/403 from a private registry in CI - the request reached the registry but the token in bun… bun install registry timeoutFix Bun install network failures in CI - Bun could not reach or download from the registry because of a timeo… Corepack download failsFix Corepack errors in CI - "Cannot find matching keyid" / signature verification failed or a failed package-… "corepack enable" EACCESFix "corepack enable" failing with EACCES in CI/Docker - Corepack cannot write yarn/pnpm shims into a Node bi… Corepack signature mismatchFix Corepack "Signature does not match" / hash-mismatch errors in CI - a packageManager hash that no longer m… "Cannot resolve module ... offline"Fix Deno "error: Cannot resolve module ..." caused by an offline or unreachable network in CI - Deno could no… "punycode … deprecated"Fix the Node "[DEP0040] The punycode module is deprecated" warning in CI - noisy on Node 21+ from a transitiv… "ECONNREFUSED 127.0.0.1"Fix Node.js "connect ECONNREFUSED 127.0.0.1:PORT" in CI - tests connect to a database or service that has not… "getaddrinfo ENOTFOUND"Fix Node.js / npm "getaddrinfo ENOTFOUND registry.npmjs.org" in CI - a DNS resolution failure for the registr… "self signed certificate in chain"Fix Node.js / npm "self signed certificate in certificate chain" in CI - caused by a TLS-intercepting proxy.… "unable to verify the first certificate"Fix Node.js / npm "unable to verify the first certificate" (UNABLE_TO_VERIFY_LEAF_SIGNATURE) in CI - a server… _authToken not expandedFix npm .npmrc _authToken auth failures in CI - a ${NPM_TOKEN} placeholder left literal because the env var i… "_authToken not configured"Configure the npm .npmrc auth token in CI so private installs authenticate, injecting the token from a secret… "npm error code E403"Fix npm "E403 403 Forbidden" while installing in CI - a registry or proxy refusing a read your token is not a… "403 Forbidden - PUT"Fix npm "403 Forbidden" when publishing in CI - caused by no publish rights, a taken package name, or republi… "404 Not Found - GET"Fix npm "404 Not Found - GET https://registry…/@scope/pkg" in CI for a private package - wrong registry, miss… "npm error code E409"Fix npm "E409 409 Conflict - PUT" when publishing in CI - a version already exists or two release jobs raced… "reading 'matches'"Fix the npm "Cannot read properties of null (reading 'matches')" internal error in CI - a corrupted npm cache… "npm ERR! cb.apply"Fix the npm "TypeError: cb.apply is not a function" internal crash in CI - a mismatched npm/Node pairing or a… "cb() never called!"Fix the npm "cb() never called!" / "npm ERR! cb.apply" internal error in CI - a corrupted cache or an outdate… "could not resolve host"Fix npm "could not resolve host registry.npmjs.org" (ENOTFOUND/EAI_AGAIN) DNS errors in CI by checking DNS, p… "self signed certificate in chain"Fix npm "self signed certificate in chain" errors in CI by trusting the corporate CA properly instead of disa… "self-signed certificate"Fix npm "self-signed certificate in certificate chain" / UNABLE_TO_GET_ISSUER_CERT_LOCALLY in CI behind a TLS… "npm warn config"Fix npm "npm warn config … is deprecated" noise in CI - old .npmrc keys (e.g. cache-min, production, optional… "npm warn deprecated"Fix cases where `npm warn deprecated` turns into an actual CI failure - a deprecated transitive package remov… "403 Forbidden (publish)"Fix npm 403 Forbidden errors when publishing in CI, caused by a bad token, a taken name, a missing version bu… "403" on scoped publishFix npm 403 when publishing a scoped package in CI - a scoped package defaulting to restricted access without… corrupted npm cacheFix npm install failing with ENOENT/integrity errors on a cached tarball in CI - a corrupted or partially-res… "npm ERR! code E401 / E403"Fix npm E401 and E403 authentication errors against a private registry in CI by configuring a valid auth toke… "npm error code E401"Fix npm E401 "Incorrect or missing auth token" and ENEEDAUTH in CI - a private registry rejecting the request… "npm ERR! code E404"Fix npm E404 "Not Found" errors in CI when a package or version does not exist at the configured registry, by… "npm error code EAI_AGAIN"Fix npm EAI_AGAIN "getaddrinfo EAI_AGAIN registry.npmjs.org" in CI - a temporary DNS failure, common inside D… "npm error code ECONNREFUSED"Fix npm "connect ECONNREFUSED" in CI - the registry actively refused the connection, usually a wrong port, a… "npm ERR! code ECONNRESET"Fix npm ECONNRESET errors in CI when the registry connection is reset mid-download, using retries, caching, a… "npm error code ENOTFOUND"Fix npm ENOTFOUND "getaddrinfo ENOTFOUND registry.npmjs.org" in CI - a DNS resolution failure reaching the re… "npm error code ENOVERSIONS"Fix npm ENOVERSIONS "No versions available for <pkg>" in CI - a package whose registry metadata lists no publ… "requires a one-time password"Fix npm EOTP "This operation requires a one-time password" in CI - a publish blocked because the account/toke… "ERR_SOCKET_TIMEOUT"Fix npm "ERR_SOCKET_TIMEOUT" / "request to … failed, reason: Socket timeout" in CI - a connection that went i… "No matching version found"Fix npm ETARGET "No matching version found for pkg@range" in CI - a version range that no published release s… "npm error code ETIMEDOUT"Fix npm ETIMEDOUT "connect ETIMEDOUT" in CI - a connection to the registry that timed out, usually a transien… "npm ERR! network ETIMEDOUT"Fix npm ETIMEDOUT and network-request-failed errors in CI with fetch retries, caching, and a mirror, since mo… "429 Too Many Requests"Fix npm registry 429 Too Many Requests errors in CI by authenticating, caching, and mirroring to stay under r… Registry ECONNRESET / 5xxFix transient npm install failures in CI - ECONNRESET, ETIMEDOUT, 429, and 5xx from the registry - with retri… Scoped @registry 404Fix a scoped-package 404 in CI - when @scope:registry is unmapped (or mapped to the wrong host) so npm querie… "GET ... request failed"Fix pnpm "ERR_PNPM_FETCH_404" and "request to registry failed" errors in CI - pnpm reached the registry but g… "ERR_PNPM_NO_OFFLINE_META"Fix pnpm "ERR_PNPM_NO_OFFLINE_META: Failed to resolve … in offline mode" in CI - --offline was used but the p… ERR_PNPM_FETCH_404Fix pnpm ERR_PNPM_FETCH_404 "GET https://…: Not Found - 404" in CI - a package or version pnpm cannot fetch f… "Environment variable not found: DATABASE_URL"Fix Prisma "Environment variable not found: DATABASE_URL" in CI - the datasource reads DATABASE_URL from the… "P1000: Authentication failed"Fix Prisma "P1000: Authentication failed against database server" in CI - the user or password in DATABASE_UR… "P1001: Can't reach database server"Fix Prisma "P1001: Can't reach database server at host:port" in CI - the database service has not started yet… "P1003: Database does not exist"Fix Prisma "P1003: Database `app` does not exist on the database server" in CI - the target database named in… "P1017: Server has closed the connection"Fix Prisma "P1017: Server has closed the connection" in CI - the database dropped the connection mid-operatio… "Timed out fetching a new connection"Fix Prisma "Timed out fetching a new connection from the connection pool" in CI - queries exceeded the pool s… pgbouncer pooled URL + directUrlFix Prisma migrate failing against a PgBouncer pooled URL in CI - migrations need a direct connection. Set di… "scoped package 404"Fix scoped package 404 errors in CI by mapping the scope to its private registry in .npmrc, since the default… "unexpected error … ENOENT"Fix yarn "An unexpected error occurred: ENOENT: no such file or directory" in CI - a missing file/directory y… "The remote server failed"Fix Yarn Berry "The remote server failed to provide the requested resource" in CI - a registry fetch returned… "couldn't be located"Fix Yarn Berry "YN0000: ... Package ... couldn't be located and ... immutable" in CI - a package archive is m…

Build & memory

Heap OOM, native modules, and toolchain gaps.

"@angular-devkit/build-angular" errorFix @angular-devkit/build-angular errors in CI - the build architect package is missing from node_modules or… "anyComponentStyle exceeded maximum budget"Fix Angular "Error: X exceeded maximum budget" for a component stylesheet in CI - a single component CSS/SCSS… "bundle initial exceeded maximum budget"Fix Angular "Error: bundle initial exceeded maximum budget" in CI - the production build produced an initial… "Can't bind to X since it isn't a known property"Fix "Can't bind to 'X' since it isn't a known property of 'Y'" in Angular CI - the module or standalone compo… "Cannot find module '@angular/...'"Fix "Cannot find module '@angular/core'" (or another @angular package) in CI - dependencies were not installe… "JavaScript heap out of memory"Fix "FATAL ERROR: Reached heap limit ... JavaScript heap out of memory" during Angular ng build in CI - a lar… "Module not found: Can't resolve"Fix "Module not found: Error: Can't resolve 'X'" in Angular CI builds - a webpack import path points at a fil… "ng lint" ESLint errorsFix "ng lint" failures in CI with angular-eslint - lint runs clean locally but errors in CI due to a missing… "ng test" hangs in watch modeFix "ng test" hanging in CI - by default ng test runs in watch mode and never exits, so the job times out. Pa… "ng: command not found"Fix "ng: command not found" in CI - the Angular CLI is not installed globally on the runner, so bare ng calls… "NG0..." runtime errorFix Angular "NG0..." runtime errors in CI - coded runtime errors like NG0100 (ExpressionChangedAfterItHasBeen… "No NgModule metadata found for"Fix "No NgModule metadata found for X" in Angular CI - bootstrap or a lazy route was pointed at a class that… "Schematic X not found"Fix "Schematic X not found in collection" or ng add/ng generate failures in CI - the schematic collection is… "Angular Compiler requires TypeScript"Fix "The Angular Compiler requires TypeScript >=X and <Y but Z was found instead" in CI - the resolved typesc… "only compatible with Angular versions"Fix "This version of CLI is only compatible with Angular versions X" in CI - the installed @angular/cli major… "Unexpected value imported by the module"Fix "Unexpected value X imported by the module Y" in Angular AOT CI builds - a non-module (a component, a ser… "is not a known element"Fix Angular "X is not a known element" (NG8001) in CI - a component or web component used in a template is no… Jest "jest-preset-angular" errorsFix jest-preset-angular failures in CI - Jest for Angular breaks when the setup file, ESM transform, or zone.… "Cannot start Chrome"Fix karma "Cannot start Chrome" / "No binary for Chrome browser" in Angular CI - the runner has no display or… "Disconnected, reconnect failed"Fix karma "Disconnected (0 times), because no message in 30000 ms" in Angular CI - the headless browser lost… production optimization build errorFix Angular production build failures that only appear with optimization enabled in CI - AOT and the optimize… "Can't find stylesheet to import"Fix Sass "Can't find stylesheet to import" in Angular CI builds - a @use or @import path resolves on a case-i… "window is not defined" (SSR/prerender)Fix "ReferenceError: window is not defined" during Angular SSR or prerender in CI - server-side rendering run… "error TS" in a template (strictTemplates)Fix Angular strict template "error TS..." failures in CI - with strictTemplates on, the compiler type-checks… "Failed to initialize database"Fix Backstage "Failed to connect to the database" / "Failed to initialize database" in CI - Postgres is unrea… "yarn build" failedFix Backstage "yarn build" failures in CI - the frontend or backend bundle step fails because of a missing en… "yarn tsc" error TSFix Backstage "yarn tsc" failing with "error TS..." in CI - the TypeScript type check finds errors that a loc… app-config ${...} not substitutedFix Backstage app-config.yaml "${...}" environment substitution failures in CI - a referenced env variable is… auth provider config missingFix Backstage "Missing required config value at auth.providers..." in CI - an auth provider is enabled but it… "JavaScript heap out of memory"Fix Backstage build "FATAL ERROR: ... JavaScript heap out of memory" in CI - the monorepo type check and bund… Backstage Docker build failsFix Backstage Docker multi-stage build failures in CI - the backend image build fails on native deps, a missi… "bun: command not found"Fix "bun: command not found" in CI - the runner has no Bun on PATH because setup-bun did not run, failed, or… "Segmentation fault" (bun)Fix Bun "Segmentation fault (core dumped)" in CI - a crash from an incompatible Bun build, an unsupported CPU… "platform is not supported"Fix Bun platform errors in CI - Bun runs natively on macOS and Linux, so a Windows runner without WSL cannot… Bun version mismatch in CIFix Bun version mismatches in CI where the runner Bun differs from the one your lockfile or packageManager fi… "corepack signature verification failed"Fix Corepack "Signature does not match" / signature verification failed in CI - the bundled keys are stale re… "Could not find ... in cache"Fix Deno "error: Could not find ... in cache" under --cached-only / --frozen in CI - a dependency was never c… "deno: command not found"Fix "deno: command not found" in CI - the runner has no Deno on PATH because the setup-deno step is missing o… "Not formatted" (deno fmt --check)Fix Deno "error: Found N not formatted files" from deno fmt --check in CI - files do not match the formatter… "Requires env access"Fix Deno "PermissionDenied: Requires env access to ... run again with the --allow-env flag" in CI - the progr… "Requires net access"Fix Deno "PermissionDenied: Requires net access to ... run again with the --allow-net flag" in CI - the progr… "Requires read access"Fix Deno "PermissionDenied: Requires read access to ... run again with the --allow-read flag" in CI - the pro… "Requires run access"Fix Deno "PermissionDenied: Requires run access to ... run again with the --allow-run flag" in CI - the progr… "Requires write access"Fix Deno "PermissionDenied: Requires write access to ... run again with the --allow-write flag" in CI - the p… "Unable to load config file"Fix Deno "error: Unable to load config file" in CI - Deno could not read or parse deno.json / deno.jsonc from… "TS2307: Cannot find module"Fix Deno "error: TS2307 Cannot find module ... or its corresponding type declarations" in CI - deno check cou… "error: TS...." (deno check)Fix Deno "error: TS...." type-check failures in CI - deno check reports TypeScript diagnostics that fail the… DENO_DIR not restoredFix slow Deno CI runs caused by DENO_DIR not being cached - every job re-downloads and re-checks all remote a… "deno lint" errorsFix deno lint failures in CI - deno lint reports rule violations that exit non-zero and fail the lint gate. Deno version mismatchFix Deno version mismatches in CI - the deno-version installed by setup-deno differs from what your code or d… @esbuild/linux-x64 missingFix esbuild "Cannot find module @esbuild/linux-x64" (or host-vs-binary version mismatch) in CI/Docker - the p… "Could not resolve ./worker"Fix esbuild "Could not resolve './worker'" in CI - a new Worker(new URL(...)) reference was not bundled becau… "Dynamic require of X is not supported"Fix esbuild "Dynamic require of 'fs' is not supported" in CI - a CommonJS module was bundled to ESM and its r… "import.meta not available (CJS output)"Fix esbuild "import.meta is not available with the cjs output format" in CI - source reads import.meta.url bu… "Top-level await is currently not supported"Fix esbuild "Top-level await is currently not supported with the cjs output format" in CI - source uses TLA b… "Transform failed with N errors"Fix esbuild "Transform failed with N errors" in CI - source uses syntax (JSX, TS, decorators) esbuild was not… "Must use import to load ES Module"Fix "Error: Must use import to load ES Module" from ESLint in CI - ESLint loaded a config or plugin written a… "--experimental-vm-modules"Fix Jest failing on ESM in CI - running ESM test files needs Node’s --experimental-vm-modules flag. Pass it v… "A circular dependency has been detected"Fix NestJS "A circular dependency has been detected inside X" in CI - two modules or providers reference each… "Cannot determine a type for the ... property"Fix NestJS "Cannot determine a type for the X property (05)" in CI - class-transformer or the mapped types pl… "Cannot find module '@nestjs/...'"Fix NestJS "Error: Cannot find module '@nestjs/common'" in CI - a required @nestjs package is not installed,… "Cannot read properties of undefined" (DI)Fix NestJS "Cannot read properties of undefined (reading X)" from an injected service in CI - a dependency re… "WARN class-validator ... not installed"Fix NestJS class-validator/class-transformer not installed in CI - ValidationPipe needs both packages, and a… "EADDRINUSE: address already in use"Fix NestJS "listen EADDRINUSE: address already in use :::3000" in e2e in CI - a previous test app was not clo… "Nest application failed to start"Fix "Error: Nest application failed to start" in CI - a lifecycle hook, module init, or async provider threw… "error TS1241" experimental decoratorsFix "nest build" TypeScript errors about decorators in CI - tsconfig is missing experimentalDecorators or emi… "Nest can't resolve dependencies"Fix NestJS "Nest can't resolve dependencies of the X (?)" in CI - a constructor argument has no matching prov… "Nest could not find ... element"Fix NestJS "Nest could not find X element (this provider does not exist in the current context)" in CI - modu… "nest: command not found"Fix "nest: command not found" in CI - the @nestjs/cli is a devDependency that was not installed, or the build… "Reflect.getMetadata is not a function"Fix NestJS reflect-metadata errors in CI - the reflect-metadata polyfill was not imported at the entrypoint,… "connect ECONNREFUSED" (TypeORM)Fix NestJS TypeOrmModule "connect ECONNREFUSED" in CI - the database service is not reachable at bootstrap be… "UnknownDependenciesException"Fix NestJS "UnknownDependenciesException" in CI - the injector could not find a provider for an injected toke… "@prisma/client did not initialize yet"Fix NestJS + Prisma "@prisma/client did not initialize yet. Please run prisma generate" in CI - the client wa… ConfigService returns undefined in CIFix NestJS ConfigModule env vars being undefined in CI - the .env file is not committed and the runner has no… "ECONNREFUSED" in e2e supertestFix NestJS e2e "connect ECONNREFUSED 127.0.0.1" with supertest in CI - the test sent a request before app.ini… "Cannot find module '@app/...'" (jest)Fix NestJS jest "Cannot find module '@app/...'" in CI - tsconfig path aliases are not mapped in jest, so add… Microservice transport ECONNREFUSEDFix NestJS microservices "Connection refused" transport errors in CI - the broker (Redis, RabbitMQ, Kafka) th… "project X does not exist" (nest monorepo)Fix NestJS monorepo build errors in CI - nest build needs the project name, and library path mappings in tsco… TestingModule not initializedFix NestJS TestingModule tests that fail because app.init() was never called in CI - guards, interceptors, an… ts-jest fails on decoratorsFix NestJS ts-jest errors in CI - ts-jest uses its own tsconfig, so decorators fail unless experimentalDecora… "No metadata for ... was found"Fix NestJS TypeORM "EntityMetadataNotFoundError: No metadata for X was found" in CI - the entities glob match… ValidationPipe rejects valid DTOFix NestJS ValidationPipe issues in CI - a global ValidationPipe with whitelist strips fields, or missing cla… "__dirname is not defined in ES module scope"Fix Node "ReferenceError: __dirname is not defined in ES module scope" in CI - the CommonJS __dirname/__filen… "__filename is not defined in ES module"Fix "__filename is not defined in ES module scope" in CI - an ESM bundle or output uses the CJS __filename gl… "bad interpreter: node\r"Fix "/usr/bin/env: ‘node\r’: No such file or directory" in CI - a bin script with Windows CRLF line endings,… "Cannot find module 'node-gyp'"Fix "Error: Cannot find module 'node-gyp'" / "gyp ERR! node-gyp not found" in CI - when a native dependency n… "Cannot find module 'node:…'"Fix Node "Cannot find module 'node:test'" / 'node:fs/promises' in CI - a node:-prefixed builtin or newer API… "Cannot find module 'node:crypto'"Fix "Cannot find module 'node:crypto'" (or other node: builtins) in CI - code uses the node:-prefixed import… "Cannot find module 'typescript'"Fix "Cannot find module 'typescript'" in CI - tsc, ts-node, or a tool needs the typescript package, but it is… "import statement outside a module"Fix "SyntaxError: Cannot use import statement outside a module" in CI - Node parsed an ESM `import` as Common… "[DEP0040] punycode module is deprecated"Fix Node "DeprecationWarning: The punycode module is deprecated" (DEP0040) in CI - a dependency imports the b… "ENOENT ... package.json"Fix Node "Error: ENOENT: no such file or directory, open package.json" during ESM/CJS resolution in CI - the… "ERR_IMPORT_ATTRIBUTE_MISSING"Fix Node JSON import errors (ERR_IMPORT_ATTRIBUTE_MISSING / ERR_IMPORT_ASSERTION_TYPE_MISSING) in CI - ESM JS… "Invalid \"exports\" target"Fix Node "Error [ERR_INVALID_PACKAGE_TARGET]: Invalid exports target" in CI - the exports field maps a subpat… "Cannot find module ... imported from"Fix Node "Error [ERR_MODULE_NOT_FOUND]: Cannot find module ... imported from" in CI - ESM relative imports mu… "Package subpath ... is not defined by exports"Fix Node "Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath is not defined by exports" in CI - the deep… "require() of ES Module ... not supported"Fix Node "Error [ERR_REQUIRE_ESM]: require() of ES Module not supported" in CI - a CommonJS file used require… "Unknown file extension \".ts\""Fix Node "TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension .ts" in CI - the ESM loader has no h… "Directory import ... is not supported"Fix Node "Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import not supported resolving ES modules" in CI - ES… "digital envelope routines::unsupported"Fix "Error: error:0308010C:digital envelope routines::unsupported" in CI - Node 17+ on OpenSSL 3 breaking old… "Allocation failed" (CI)Fix Node "FATAL ERROR: … Allocation failed" specifically in CI - tune V8 heap and semi-space for a constraine… "FATAL ERROR: Reached heap limit - Allocation failed"Fix the Node.js "FATAL ERROR: Reached heap limit Allocation failed" out-of-memory crash in CI by raising the… "Must use import to load ES Module"Fix Node "Error [ERR_REQUIRE_ESM]: Must use import to load ES Module" in CI - CommonJS code require()-ing a p… "The requested module ... does not provide an export"Fix Node "SyntaxError: Named export not found. The module is a CommonJS module" in CI - ESM cannot statically… "Maximum call stack size exceeded"Fix "RangeError: Maximum call stack size exceeded" during a build/bundle in CI - deep recursion from a circul… "exports is not defined in ES module scope"Fix Node "ReferenceError: exports is not defined in ES module scope" in CI - CommonJS exports/module.exports… "fetch is not defined"Fix Node "ReferenceError: fetch is not defined" in CI - the global fetch API is only built in on Node 18+; ol… "require is not defined in ES module scope"Fix Node "ReferenceError: require is not defined in ES module scope" in CI - the file runs as an ES module wh… "structuredClone is not defined"Fix Node "ReferenceError: structuredClone is not defined" in CI - the structuredClone global was added in Nod… "Segmentation fault"Fix Node "Segmentation fault" (signal SIGSEGV) in CI builds/tests - a native crash from a bad binary, a corru… "Segmentation fault (core dumped)"Fix Node.js segmentation faults from a native addon in CI by rebuilding the addon for the runner, upgrading i… "Cannot use import statement outside a module"Fix Node "SyntaxError: Cannot use import statement outside a module" in CI - the file used ESM import syntax… "top-level await is only available in ES modules"Fix Node "SyntaxError: Unexpected reserved word" / "top-level await is only available in ES modules" in CI -… "Unexpected token 'export'"Fix Node "SyntaxError: Unexpected token export" in CI - a file with ESM export syntax was parsed as CommonJS,… "Unsupported engine ... required: { node }"Fix npm "Unsupported engine" / "engine node is incompatible" in CI - the runner Node version does not satisfy… "To load an ES module, set type: module"Fix Node "Warning: To load an ES module, set type: module in the package.json or use the .mjs extension" in C… "WASM module compile failed"Fix "WebAssembly.compile(): ... module compile failed" in CI - a .wasm asset was truncated, served with the w… "Error: Worker terminated due to reaching memory limit"Fix the Node.js "Worker terminated due to reaching memory limit" error in CI by raising the worker heap, lowe… "node: bad option (build step)"Fix a build step where Node rejects a flag as "bad option" in CI by aligning the Node version with the build… CJS/ESM interop breakFix CJS/ESM interop errors in CI - "X is not a function" or "default is not a function" when a CommonJS packa… "ERR_MODULE_NOT_FOUND"Fix Node ERR_MODULE_NOT_FOUND in CI - an ESM import that fails because the path is missing its file extension… "ERR_REQUIRE_ESM"Fix Node ERR_REQUIRE_ESM "require() of ES Module not supported" in CI - a CommonJS require of an ESM-only pac… "Could not find … Python"Fix node-gyp "Could not find any Python installation to use" in CI - native addon builds need Python; install… "gyp ERR! build error"Fix node-gyp "gyp ERR! build error" in CI - native addon compilation failing due to a missing compiler toolch… Prebuilt binary not foundFix node-pre-gyp "Prebuilt binary … not found, trying source compile" in CI - when no prebuilt binary exists… "__dirname is not defined"Fix ReferenceError "__dirname is not defined in ES module scope" in CI - the CommonJS path globals do not exi… "--loader is deprecated"Fix Node.js "ExperimentalWarning: --loader is deprecated, use --import instead" in CI - migrate custom ESM lo… "AbortError: operation was aborted"Fix Node.js "AbortError: The operation was aborted" / ERR_ABORTED in CI - an AbortSignal timeout fired on a f… "Cannot find module './dist'"Fix "Cannot find module './dist/index.js'" in CI - the compiled output directory does not exist because the b… "Cannot find module 'node-fetch'"Fix node-fetch import failures in CI - node-fetch v3 is ESM-only, so require() of it from CommonJS throws or… "Cannot find package"Fix Node.js "Cannot find package '#alias'" / import-map resolution errors in CI - the package.json "imports"… "connect ECONNREFUSED 127.0.0.1"Fix "connect ECONNREFUSED 127.0.0.1:<port>" in CI - a test connected before the local server it depends on wa… "EMFILE: too many open files"Fix Node.js "EMFILE: too many open files" in CI builds and tests - the process exceeded its file-descriptor l… "ENOMEM" / cannot allocateFix Node.js "ENOMEM" and "spawn ENOMEM" / "Cannot allocate memory" in CI - the runner ran out of RAM while No… "ERR_UNSUPPORTED_DIR_IMPORT"Fix Node.js ERR_UNSUPPORTED_DIR_IMPORT in CI - an ESM import targeted a directory instead of a file, which th… "socket hang up"Fix "Error: socket hang up" (ECONNRESET) in CI - the connection closed before a complete HTTP response was re… "getaddrinfo ENOTFOUND"Fix "getaddrinfo ENOTFOUND <host>" in CI tests - a hostname did not resolve, from a real DNS blip, a missing… "not allowed in NODE_OPTIONS"Fix Node.js "<flag> is not allowed in NODE_OPTIONS" in CI - only a subset of CLI flags can be passed via the… "JavaScript heap out of memory"Fix "FATAL ERROR: Reached heap limit - JavaScript heap out of memory" in CI builds by raising the V8 heap lim… "Maximum call stack size exceeded"Fix Node.js "RangeError: Maximum call stack size exceeded" in CI - usually unbounded recursion. Why --stack-s… "Must use import to load ES Module"Fix ERR_REQUIRE_ESM "Must use import to load ES Module" in CI - a CommonJS file called require() on a depende… "read ECONNRESET"Fix "Error: read ECONNRESET" in CI HTTP tests - the peer reset the TCP connection mid-read, usually a transie… "Segmentation fault"Diagnose a Node.js "Segmentation fault" (signal SIGSEGV) in CI - a crash inside a native addon or V8, not a J… "TypeError: fetch failed"Fix "TypeError: fetch failed" from Node's built-in undici fetch in CI - a low-level network, DNS, or TLS fail… "vm.Module not available"Fix Node.js "vm.Module is not available" / "must be run with --experimental-vm-modules" in CI - the VM ESM AP… "ERR_DLOPEN_FAILED"Fix Node.js ERR_DLOPEN_FAILED "invalid ELF header" / "wrong ELF class" / NODE_MODULE_VERSION mismatch in CI -… "ERR_INTERNAL_ASSERTION"Fix Node.js ERR_INTERNAL_ASSERTION in CI - an internal invariant Node expected was violated, often a buggy na… "ERR_INVALID_ARG_TYPE"Fix Node.js ERR_INVALID_ARG_TYPE "The \"path\" argument must be of type string. Received undefined" in CI - a… "ERR_OSSL_EVP_UNSUPPORTED"Fix Node.js ERR_OSSL_EVP_UNSUPPORTED "error:0308010C:digital envelope routines::unsupported" in CI - OpenSSL… "is not defined by exports"Fix Node.js ERR_PACKAGE_PATH_NOT_EXPORTED "No exports main / subpath … is not defined" in CI - a deep import… "ERR_REQUIRE_ESM"Fix Node.js ERR_REQUIRE_ESM in CI when a CommonJS file requires a dependency that went ESM-only - a package t… "Directory import … is not supported"Fix Node.js ERR_UNSUPPORTED_DIR_IMPORT "Directory import … is not supported resolving ES modules" in CI - imp… "ERR_WORKER_OUT_OF_MEMORY"Fix Node.js ERR_WORKER_OUT_OF_MEMORY "Worker terminated due to reaching memory limit" in CI - a worker’s reso… "ERR_MODULE_NOT_FOUND"Fix Node.js ESM "ERR_MODULE_NOT_FOUND" caused by extensionless relative imports - native ESM requires the .js… "Cannot find module …/dist/…"Fix Node.js MODULE_NOT_FOUND when importing a package subpath in CI - a deep path that does not exist in the… Circular dependency at loadFix Node.js circular-dependency failures in CI - "Cannot access \"X\" before initialization" or an undefined… Worker heap out of memoryFix Node.js worker_threads "JavaScript heap out of memory" / ERR_WORKER_OUT_OF_MEMORY in CI - a Worker hittin… "ENOTEMPTY … rename"Fix npm "ENOTEMPTY: directory not empty, rename" in CI - npm failed to atomically move a staged package over… "EPERM … rename"Fix npm "EPERM: operation not permitted, rename" on the .staging path in CI/Docker - a locked, root-owned, or… "EROFS: read-only file system"Fix npm "EROFS: read-only file system" in CI/Docker - npm tried to write (cache, node_modules, prefix) to a r… "Nx Could not find project"Fix Nx "Cannot find project 'X'" in CI - the project name passed to nx run is not in the project graph, or th… "externalDependencies are not hashed"Fix Nx caching staleness from inputs that reference externalDependencies that are not hashed in CI - a target… "Cannot find module" (pnpm)Fix "Cannot find module X" after a pnpm install in CI - pnpm’s strict, non-flat node_modules surfaces phantom… "Cannot find module" (pnpm hoisting)Fix pnpm "Cannot find module X" caused by strict node_modules in CI - pnpm does not hoist undeclared dependen… pnpm store re-downloaded every runFix slow pnpm installs in CI caused by an uncached content-addressable store - without caching ~/.pnpm-store… prebuild-install fallbackFix prebuild-install warnings that fall back to a source compile in CI - no prebuilt binary for your platform… prebuild-install fetch failFix prebuild-install failing to download a native binary in CI - a network/CDN error forcing a source compile… "PrismaClientInitializationError"Fix "PrismaClientInitializationError" in CI - the client could not start because the engine, environment, or… "could not locate the Query Engine"Fix "Prisma Client could not locate the Query Engine for runtime" in CI - the generated engine binary does no… "Unable to require(libquery_engine)"Fix Prisma "Unable to require(libquery_engine-linux-musl.so.node)" on Alpine in CI - the musl engine needs li… "Failed to fetch the engine file"Fix Prisma engine download failures in CI - generate cannot fetch the Query Engine over the network. Use PRIS… "Cannot find module '@builder.io/qwik-city'"Fix "Cannot find module '@builder.io/qwik-city'" in CI - the QwikCity package is not installed on the runner,… "captured ... not serializable"Fix Qwik "Code that is dynamically imported ... captured a value that is not serializable" in CI - a $ bounda… eslint-plugin-qwik use hook ruleFix "eslint-plugin-qwik" failures in CI - a use hook (useSignal, useStore, useTask$) was called outside a com… "qwik build" failedFix "qwik build" failures in CI - the Qwik build (client + server + optimizer) exited non-zero from a missing… "server$" boundary errorFix Qwik "server$" errors in CI - a server$ function captured a non-serializable value or was called with arg… qwikVite not in vite.configFix Qwik "build failed" in CI when qwikVite / qwikCity plugins are missing from vite.config - Qwik JSX and $… env var undefined (no PUBLIC_ prefix)Fix Qwik client env vars that are undefined in CI - only variables prefixed PUBLIC_ are exposed to the browse… Qwik SSR serialization mismatchFix Qwik SSR serialization/hydration mismatches in CI - server-rendered state differs from what the client re… Qwik optimizer "$" capture errorFix Qwik optimizer errors in CI - the $ optimizer rejected a component$ or useVisibleTask$ boundary because i… Node engine unsupportedFix Qwik and SolidStart builds that fail in CI on an old Node - the toolchain requires a newer Node engine, s… QwikCity adapter mismatchFix QwikCity deploys that fail in CI because no adapter (static, express, cloudflare-pages, vercel-edge) matc… onStaticGenerate / getStaticPathsFix QwikCity static (SSG) build errors in CI - dynamic routes without an onStaticGenerate/getStaticPaths list… sharp runtime mismatchFix sharp "Could not load the sharp module using the linux-x64 runtime" in CI/Docker - a platform-specific bi… "babel-preset-solid" transform failedFix "babel-preset-solid" transform failures in CI - the Solid Babel preset could not compile a component, usu… "[vite] build failed" (no solid plugin)Fix SolidJS "build failed" in CI when vite-plugin-solid is not in vite.config - Solid JSX is not transformed… "Cannot find module 'solid-js'"Fix "Cannot find module 'solid-js'" in CI - the core Solid package is not installed in the runner environment… createSignal outside reactive scopeFix SolidJS tests that fail in CI while the build passes - reading a createSignal getter outside a reactive s… wrong jsxImportSource for SolidFix SolidJS TypeScript JSX type errors in CI - tsconfig has the wrong jsx/jsxImportSource, so tsc types JSX f… "document is not defined" (Vitest)Fix SolidJS Vitest "document is not defined" in CI - the test environment defaults to node with no DOM, so re… @solidjs/start wrong presetFix SolidStart builds that fail or deploy wrong in CI because the @solidjs/start server preset does not match… "Hydration Mismatch"Fix SolidStart "Hydration Mismatch" in CI - the server-rendered markup differed from the first client render,… "cannot be used" (server$)Fix SolidStart server function errors in CI - a "use server" / server function was called from a place the co… "vinxi build" failedFix "vinxi build" failures in CI for SolidStart - the vinxi bundler that drives SolidStart exited non-zero, f… env var undefined (no VITE_ prefix)Fix SolidStart client env vars that are undefined in CI - Vite only exposes variables prefixed VITE_ to clien… "window is not defined" (SSR)Fix SolidStart "ReferenceError: window is not defined" in CI - a browser-only API ran during server-side rend… "ERR_UNKNOWN_FILE_EXTENSION"Fix ts-node "TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension .ts" in CI - Node’s ESM loader do… ts-node register mismatchFix ts-node registration failures in CI - "Cannot use import statement", "Unknown file extension .ts", or ESM… tsx ESM loader errorFix tsx ESM loader problems in CI - "--loader is deprecated" warnings, "module is not defined in ES module sc… tsx not registeredFix tsx not transforming TypeScript in CI - "Unknown file extension .ts" because tsx was not registered. Use… "turbo command finished with error"Fix Turborepo "command (...) exited (1)" / "command finished with error" in CI - one task in the pipeline fai… "could not find turbo.json"Fix Turborepo "Could not find turbo.json" in CI - turbo was run outside the monorepo root, or the config is m… "Cannot find module or its type declarations"Fix TS2307 "Cannot find module 'X' or its corresponding type declarations" during a CI build - a missing depe… "TS5057 cannot find tsconfig"Fix TS5057 "Cannot find a tsconfig.json file at the specified directory" in CI - tsc was run with a -p path o… package types not foundFix TypeScript failing to resolve a dependency’s types in CI - a package "exports" map missing a "types" cond… "did you mean ... ./file.js?"Fix TypeScript NodeNext "Relative import paths need explicit file extensions ... did you mean ./file.js?" in… "Failed to resolve entry for package"Fix Vite "Failed to resolve entry for package" in CI - a dependency's package.json exports map does not expos… .yarnrc.yml ignored or wrong versionFix Yarn Berry cases where .yarnrc.yml settings (nodeLinker, yarnPath) are ignored in CI - usually Yarn class… Yarn .yarn/cache re-fetched every runFix slow Yarn Berry installs in CI - without committing or caching .yarn/cache every run re-downloads all pac… "Cannot find module" under Plug'n'PlayFix Yarn Berry Plug'n'Play "Cannot find module X" in CI - a tool that does not understand PnP resolution fail… "Cannot find module" (PnP)Fix Yarn Berry Plug’n’Play "Cannot find module" in CI - a tool that does not understand PnP cannot resolve pa…

Scripts & lifecycle

ELIFECYCLE, exit codes, and hook failures.

"tsx watch" in CIFix "tsx watch" (and other watch-mode runners) hanging or exiting wrong in CI - a watcher is meant for dev, n… "Conflicting entityRef"Fix Backstage catalog "Conflicting entityRef" / duplicate entity in CI - two locations define the same kind,… "InputError: entity ... invalid"Fix Backstage catalog "InputError: Malformed envelope, ..." / entity invalid in CI - a catalog-info.yaml is m… "Placeholder could not be resolved"Fix Backstage catalog "Placeholder $text/$json/$yaml could not be resolved" in CI - a catalog-info.yaml place… "Unable to read url ... 404"Fix Backstage catalog "Unable to read url ... 404 Not Found" in CI - a component location points at a catalog… GITHUB_TOKEN not set for integrationsFix Backstage integrations "GITHUB_TOKEN" missing in CI - the GitHub integration has no token, so catalog rea… "action ... is not registered"Fix Backstage scaffolder "Template action ... is not registered" in CI - a software template references a sca… "mkdocs: command not found"Fix Backstage TechDocs "mkdocs: not found" in CI - local TechDocs generation needs python3, mkdocs, and mkdoc… "Failed to generate docs"Fix Backstage "techdocs-cli generate" failures in CI - mkdocs build errors, a missing plugin, or a bad docs_d… "Could not find any files ... mkdocs.yml"Fix Backstage TechDocs "Could not read mkdocs.yml" in CI - the entity has a TechDocs annotation but no mkdocs… "Blocked ... postinstall"Fix Bun blocking postinstall/lifecycle scripts in CI - Bun does not run untrusted install scripts by default,… "Cannot find module" / "Could not resolve"Fix Bun "error: Cannot find module" and "Could not resolve" in CI - Bun could not resolve an import because t… "Cannot find package ... imported from"Fix Bun "Cannot find package X imported from Y" in CI - an ESM import resolves to a package that is not insta… "Script not found"Fix Bun "error: Script not found" in CI - `bun run <name>` cannot find that script in package.json, from a ty… "expect(received).toBe(expected)"Fix bun:test assertion failures in CI - an expect() matcher did not hold. Read the expected versus received v… "FileNotFound" package.jsonFix Bun "error: FileNotFound" for package.json and ENOENT in CI - Bun ran in a directory with no package.json… "not yet implemented in Bun"Fix Bun "node:X is not yet implemented in Bun" in CI - code imports a Node built-in module or feature Bun has… "PostgresError" in bun testFix "PostgresError" from Bun sql / postgres in CI - a database test could not connect or query because the se… "test failed" (bun test)Fix `bun test` failing CI - one or more tests failed, so bun test exits nonzero and fails the job. Read the f… "is not a function" (Node API gap)Fix Bun "TypeError: X is not a function" in CI - a Node.js API a dependency calls is not implemented (or diff… "ENOENT" in bun testFix "ENOENT: no such file or directory" during bun test in CI - a test reads a fixture by a path that does no… "concurrently" command failedFix concurrently failing in CI - "concurrently: not found", or one parallel command exiting non-zero failing… "No test modules found"Fix Deno "error: No test modules found" in CI - deno test matched no files, so the step exits nonzero without… deno test exits nonzeroFix Deno "deno test" nonzero exit in CI - one or more test cases failed or threw, so deno test exits with a n… Top-level await never resolvesFix Deno CI jobs that hang or fail on a top-level await that never resolves - the module waits forever on a p… "husky … command not found"Fix husky hooks failing with "command not found" in CI - a tool invoked by a hook is not on PATH, or the hook… "husky prepare script failed"Fix husky prepare-script failures in CI, caused by husky trying to install Git hooks where there is no .git d… "JavaScript heap out of memory"Fix "FATAL ERROR: ... JavaScript heap out of memory" during an npm build in CI by raising the V8 heap limit a… "Cannot find module" (Jest alias)Fix Jest "Cannot find module '@/...'" in CI - a TypeScript path alias resolves in tsc but Jest has no matchin… "Worker terminated"Fix "Jest worker encountered 4 child process exceptions" / worker terminated in CI - a test worker crashed, o… "--experimental-vm-modules flag" requiredFix Jest ESM "To use ECMAScript Modules you must set the --experimental-vm-modules flag" in CI - native ESM t… "node: --experimental-vm-modules"Fix Jest ESM failures in CI that demand node --experimental-vm-modules by enabling the flag through NODE_OPTI… "ERR_OSSL_EVP_UNSUPPORTED"Fix "error:0308010C digital envelope routines::unsupported" (ERR_OSSL) in npm builds on Node 17+ by upgrading… "no tests found"Fix Node.js built-in test runner finding no tests in CI - node --test using its default file patterns, or the… node --test glob no matchFix node --test glob patterns matching nothing in CI - the shell expanded (or failed to expand) the glob, or… "bad option: --experimental-vm-modules"Fix Node "bad option: --experimental-vm-modules" in CI - the flag was passed where Node could not accept it,… "node: bad option"Fix the Node.js "bad option" unknown-flag error in CI by removing the flag, fixing its spelling, or using a N… "Error: Cannot find module 'node:X'"Fix the Node.js "Cannot find module node:X" error in CI by upgrading to a Node version that supports the node… "Error: Cannot find package 'X' imported from"Fix the Node.js "Cannot find package X imported from" ESM error in CI by installing the dependency or correct… "Cannot read properties of undefined (reading 'X')"Fix the Node.js "Cannot read properties of undefined (reading X)" TypeError in CI by guarding the access or e… "Cannot use import statement outside a module"Fix the Node.js "SyntaxError: Cannot use import statement outside a module" in CI by telling Node to treat th… "Error: Dynamic require of 'X' is not supported"Fix the "Dynamic require of X is not supported" error from bundled ESM in CI by bundling for CommonJS or mark… "ENOENT: no such file or directory, open"Fix the Node.js "ENOENT: no such file or directory, open" error in CI by resolving paths against the right wo… "ENOENT: ... open '.env'"Fix a Node.js missing .env file at runtime in CI by providing the variables through workflow env or secrets i… "Error: Cannot find module 'X'"Fix the Node.js "Error: Cannot find module" crash in CI by correcting the path, extension, or build output th… "Error: write EPIPE"Fix the Node.js "Error: write EPIPE" in CI by handling the stream error when a downstream reader closes the p… "error:0308010C digital envelope routines::unsupported"Fix the Node.js "error:0308010C digital envelope routines::unsupported" OpenSSL 3 error in CI by upgrading th… "ExperimentalWarning: --loader is deprecated"Fix the Node.js "--loader is deprecated" experimental warning in CI by moving to the --import flag with modul… "Error: listen EACCES: permission denied"Fix the Node.js "listen EACCES: permission denied" error in CI by binding to an unprivileged port above 1024… "RangeError: Maximum call stack size exceeded"Fix the Node.js "RangeError: Maximum call stack size exceeded" in CI by breaking the infinite recursion or co… "process.exit(1)"Fix CI jobs failing on a Node.js process.exit(1) by finding the deliberate exit call and addressing the condi… "ReferenceError: X is not defined"Fix the Node.js "ReferenceError: X is not defined" in CI by importing the symbol, defining the variable, or r… "Error: spawn X ENOENT"Fix the Node.js "spawn ENOENT" child-process error in CI by installing the missing executable or correcting t… "SyntaxError: Unexpected token 'export'"Fix the Node.js "SyntaxError: Unexpected token export" in CI by loading the file as ESM or compiling the ESM-… "The engine 'node' is incompatible with this module"Fix the "engine node is incompatible" error in CI by pinning the CI Node version to satisfy the engines field… "Timeout - Async callback was not invoked"Fix the "Timeout - Async callback was not invoked within the timeout" test error in CI by resolving the pendi… "TypeError: X is not a function"Fix the Node.js "TypeError: X is not a function" in CI by correcting a bad import shape, a missing method, or… "AssertionError [ERR_ASSERTION]"Fix the Node.js AssertionError in CI by correcting the value that violates the assertion or fixing the assert… "<default import> is not a function"Fix a CommonJS-from-ESM default-import "is not a function" error in CI by reading the real callable off the i… "DeprecationWarning (treated as error)"Fix CI jobs failing on a Node.js DeprecationWarning by replacing the deprecated API or removing the --throw-d… "EADDRINUSE: address already in use"Fix the Node.js EADDRINUSE "address already in use" error for a test server in CI by closing the previous lis… "Error [ERR_INTERNAL_ASSERTION]"Diagnose the Node.js ERR_INTERNAL_ASSERTION error in CI by upgrading Node, removing the misbehaving native ad… "TypeError [ERR_INVALID_ARG_TYPE]"Fix the Node.js ERR_INVALID_ARG_TYPE error in CI by passing the argument type a core API expects instead of u… "Error [ERR_MODULE_NOT_FOUND]"Fix the Node.js ERR_MODULE_NOT_FOUND error in CI by adding the missing file extension or correcting the ESM i… "Error [ERR_PACKAGE_PATH_NOT_EXPORTED]"Fix the Node.js ERR_PACKAGE_PATH_NOT_EXPORTED error in CI by importing a subpath the package exports map expo… "Error [ERR_REQUIRE_ESM]: require() of ES Module"Fix the Node.js ERR_REQUIRE_ESM error in CI by switching to a dynamic import, pinning a CommonJS-compatible v… "RangeError [ERR_SOCKET_BAD_PORT]"Fix the Node.js ERR_SOCKET_BAD_PORT error in CI by passing an integer port in range instead of undefined, a s… "ERR_UNKNOWN_FILE_EXTENSION .ts"Fix the Node.js ERR_UNKNOWN_FILE_EXTENSION ".ts" error in CI by running TypeScript through tsx, ts-node, or a… "Error [ERR_UNSUPPORTED_DIR_IMPORT]"Fix the Node.js ERR_UNSUPPORTED_DIR_IMPORT error in CI by importing an explicit file path instead of a direct… "node-gyp rebuild failed"Fix node-gyp rebuild failures triggered at runtime in CI by installing the build toolchain and matching the a… "Error: dlopen ... .node"Fix Node.js native addon dlopen failures at runtime in CI by rebuilding the addon against the runner Node ver… "tsx/ts-node could not resolve module"Fix tsx and ts-node runtime resolution errors in CI by aligning the loader, module setting, and import extens… "UnhandledPromiseRejection"Fix Node.js UnhandledPromiseRejection crashes in CI by awaiting or catching the rejecting promise so the proc… "subtest … was not run"Fix Node.js built-in test runner warnings in CI - "test … did not finish" or a subtest not awaited, where asy… "--env-file" errorsFix Node.js --env-file failures in CI - a missing .env path, an unsupported Node version, or a parse error st… "--unhandled-rejections"Understand Node.js --unhandled-rejections modes (throw/strict/warn/none) - why a job that used to warn now ex… "Cannot read tailwind.config.js"Fix Tailwind config load failures in CI - a tailwind.config.js using ESM syntax in a CommonJS project (or vic… "command failed" (concurrently)Fix a concurrently run that fails in CI - one of the parallel commands exited non-zero (or a long-running one… "cross-env: command not found"Fix "cross-env: command not found" in CI - the cross-env binary is missing because devDependencies were prune… "digital envelope routines::unsupported"Fix the Webpack 4 "digital envelope routines::unsupported" OpenSSL crash in CI - newer Node's OpenSSL 3 break… "EMFILE: too many open files"Fix "EMFILE: too many open files" in CI - a build or test opened more file descriptors than the runner ulimit… "ENAMETOOLONG"Fix "ENAMETOOLONG: File name too long" in CI - a deeply nested node_modules path or long argument list exceed… "ENOSPC file watchers"Fix "ENOSPC: System limit for number of file watchers reached" in CI - a watcher (nodemon, dev server) exceed… "ERR_STREAM_PREMATURE_CLOSE"Fix Node.js "Premature close" / ERR_STREAM_PREMATURE_CLOSE in CI - a stream or pipeline ended before it finis… "ERR_UNHANDLED_REJECTION"Fix Node.js "UnhandledPromiseRejection" / ERR_UNHANDLED_REJECTION that crashes a CI process with a non-zero e… "error:0308010C"Fix "error:0308010C:digital envelope routines::unsupported" in CI - OpenSSL 3 in newer Node rejects a legacy… "husky install failed"Fix a failing husky install from the prepare lifecycle in CI - husky tries to set up git hooks where there is… "MaxListenersExceededWarning"Fix Node.js "MaxListenersExceededWarning: Possible EventEmitter memory leak detected" in CI - the warning mea… "nodemon never exits"Fix a CI job that hangs or times out because a nodemon watcher was started in a non-interactive pipeline that… "PostCSS plugin requires PostCSS 8"Fix "Loading PostCSS plugin failed: requires PostCSS 8" in CI - a plugin expects PostCSS 8 but the resolved t… "rimraf: command not found"Fix "rimraf: command not found" in CI - the rimraf clean utility is missing because it was not installed or d… "spawn EACCES"Fix "Error: spawn EACCES" in CI - a child process or script could not be executed because it lacks the execut… "ts-node ESM loader error"Fix ts-node ESM loader failures in CI - running TypeScript as ESM with ts-node needs the right loader flag an… "uncaughtException"Fix a Node.js uncaught synchronous exception that aborts a CI process with exit code 1 - a thrown error escap… process.exit() in testsFix process.exit() called inside tests or app code under test - it truncates buffered output, skips remaining… "cb() never called!"Fix npm "cb() never called!" or "Unexpected end of JSON input" / EOF during install in CI - usually a corrupt… "npm ERR! missing script: build"Fix "npm ERR! missing script: build" in CI when the named script is not defined in package.json scripts, or t… "Missing script"Fix npm "Missing script: build" in CI - npm run cannot find the named script because it is absent, misspelled… "Missing script"Fix npm "Missing script: <name>" in CI - npm run was called for a script not defined in package.json, a typo,… "signal SIGKILL"Fix npm "command failed signal SIGKILL" (exit 137) in CI - an npm script process killed by the OS, almost alw… "npm ERR! code ELIFECYCLE"Understand npm ELIFECYCLE and non-zero "Exit status" errors in CI - they mean your script failed. How to find… "postinstall script failed"Fix npm postinstall script failures in CI by finding what the hook actually runs (native build, download, cod… pre/post hook failsFix surprising CI failures from npm pre/post lifecycle scripts - a failing `pre<x>`/`post<x>` hook fails the… args swallowed by npm runFix npm run arguments not reaching the underlying command in CI - flags consumed by npm instead of the script… "spawn … ENOENT"Fix npm scripts failing with "spawn ENOENT" or "sh: <cmd>: not found" in CI - a command in the script is not… "npm run build exited with code 1"Diagnose "npm run build exited with code 1" in CI by reading the real build error above the npm wrapper inste… "command not found" in npm scriptFix "command not found" inside an npm script in CI by installing the tool as a devDependency or ensuring node… "command not found" (127)Fix npm scripts failing with exit code 127 "command not found" in CI - a binary the script calls is not insta… Shell-syntax script failFix npm scripts that fail across runners - POSIX env-var syntax (FOO=bar cmd) or && chaining behaving differe… Env var not expandingFix npm scripts where an env var prints literally (e.g. "%NODE_ENV%" or "$NODE_ENV") in CI - shell-syntax and… "npx: command not found"Fix npx failing in CI - "<command>: not found" or a 404 fetching the package - when the tool is not installed… "could not determine executable to run"Fix the modern npx "npm error could not determine executable to run" in CI - when the installed package expos… "could not determine executable"Fix npx "npm error could not determine executable to run" in CI - when npx cannot map a package name to a run… "browserType.launch missing dependencies"Fix Playwright "browserType.launch: Host system is missing dependencies" in CI - the Linux runner lacks the s… "test.describe called in wrong scope"Fix Playwright "Playwright Test did not expect test.describe() to be called here" in CI - describe/test was i… "pnpm: command not found"Fix "pnpm: command not found" in CI - the runner does not ship pnpm on PATH. Enable it with corepack or pnpm/… "recursive run failed"Fix pnpm "ERR_PNPM_RECURSIVE_RUN_FIRST_FAIL <pkg>@<ver> <script>: Failed" in CI - a script failed in one work… "does not match the defined packageManager"Fix corepack "This project is configured to use pnpm because of a packageManager field" mismatch in CI - the… "@prisma/client did not initialize yet"Fix Prisma "@prisma/client did not initialize yet. Please run 'prisma generate'" in CI - the generated client… "Cannot find module '.prisma/client'"Fix "Error: Cannot find module '.prisma/client'" in CI - the generated client output directory does not exist… "EACCES: permission denied" (generate)Fix "prisma generate" failing with "EACCES: permission denied" in CI - the generate step cannot write the cli… "prisma: command not found"Fix "prisma: command not found" in CI - the Prisma CLI is a local dev dependency and is not on PATH, so a bar… "@semantic-release/exec" command failedFix a failing @semantic-release/exec step in CI - a shell command you configured (prepareCmd, publishCmd) exi… "@semantic-release/git" failedFix a failing @semantic-release/git prepare/publish step in CI - it commits changelog and package files back… "Cannot find module @semantic-release/..."Fix semantic-release "Cannot find module '@semantic-release/git'" (or similar) in CI - a plugin listed in con… "EGITHUBBADTOKENSCOPE"Fix semantic-release "EGITHUBBADTOKENSCOPE The GitHub token doesn't allow to push" in CI - the GitHub token l… "EGITNOPERMISSION"Fix semantic-release "EGITNOPERMISSION The push permission to the Git repository is required" in CI - the tok… "branch is not configured"Fix semantic-release running on a branch that is not in the branches config in CI - it skips the release beca… "EINVALIDNPMTOKEN"Fix semantic-release "EINVALIDNPMTOKEN Invalid npm token" in CI - the NPM_TOKEN was provided but the registry… "ENOGHTOKEN"Fix semantic-release "ENOGHTOKEN No GitHub token specified" in CI - the @semantic-release/github plugin found… "ENOTINGITREPOSITORY"Fix semantic-release "ENOTINGITREPOSITORY Not running from a git repository" in CI - the working directory ha… "ENPMTOKEN"Fix semantic-release "ENPMTOKEN No npm token specified" in CI - the @semantic-release/npm plugin needs NPM_TO… "fatal: could not read Username"Fix semantic-release "fatal: could not read Username for https://github.com" in CI - checkout persisted no cr… "no new version is released"Understand semantic-release "There are no relevant changes, so no new version is released" in CI - the analyz… "not triggered in a known CI environment"Fix semantic-release "This run was not triggered in a known CI environment" - it did not detect CI, so it ran… "remote repository could not be found"Fix semantic-release "The git repository could not be found" in CI - the resolved repositoryUrl is wrong or t… "local branch is behind the remote"Fix semantic-release "The local branch X is behind the remote one, therefore a new version won't be published… commits do not match conventionFix semantic-release not releasing because commits do not follow Conventional Commits in CI - the commit-anal… no semantic-release configurationFix semantic-release finding no configuration in CI - no .releaserc, release.config.js, or release field in p… monorepo wrong package releasedFix semantic-release in a monorepo releasing based on unrelated commits in CI - without per-package filtering… npm "E401" verifying registryFix semantic-release npm E401 Unauthorized when @semantic-release/npm verifies the registry in CI - the .npmr… npm publish "403 Forbidden"Fix semantic-release npm publish failing with "403 Forbidden" in CI - the token authenticated but is not allo… protected branch push rejectedFix semantic-release push rejected by a protected branch rule in CI - the default GITHUB_TOKEN cannot bypass… shallow clone (fetch-depth)Fix semantic-release not finding tags or commits in CI because actions/checkout made a shallow clone - set fe… "Unknown file extension .ts" (tsx)Fix "Unknown file extension .ts" when running TypeScript with tsx in CI - tsx was not actually loaded, so Nod… "TS2589 excessively deep"Fix TS2589 "Type instantiation is excessively deep and possibly infinite" in CI - a recursive or overly compl… "Reached heap limit Allocation failed" (tsc)Fix "FATAL ERROR: Reached heap limit Allocation failed" during tsc in CI - type-checking a large project exha… "[rollup] Could not resolve"Fix Rollup "Could not resolve" during a Vite build in CI - an import has no installed package and is not decl… "Vitest Failed to load url"Fix Vitest "Failed to load url ... (resolved id: ...)" in CI - an import using a path alias was not resolved… "No test suite found in file"Fix Vitest "No test suite found in file" in CI - a matched file contains no test() or describe() blocks, or i… "Vitest caught unhandled error"Fix "Vitest caught 1 unhandled error during the test run" in CI - an async rejection or timer fired outside a… "Vitest workspace config not found"Fix Vitest "Workspace config file ... was not found" in CI - the --workspace path or vitest.workspace file is… Test runner OOMFix Vitest/Jest "JavaScript heap out of memory" or SIGKILL (exit 137) in CI - test runs that exhaust memory t… "Command failed with exit code 1"Understand yarn "error Command failed with exit code 1" in CI - it is a wrapper around a script that failed.… "Usage Error" (corepack / version)Fix Yarn "Usage Error" and "command not found" from corepack version mismatches in CI - the packageManager fi… "Couldn't find the workspaces focus command"Fix Yarn Berry "yarn workspaces focus" failures in CI - the command is provided by the workspace-tools plugin…
Explore other topics
GitHub ActionsWorkflow, runner, and YAML errors - diagnosed and fixed. DockerBuild, run, compose, and registry errors - explained. Pythonpip, poetry, venv, and pytest failures - fixed. Java & JVMMaven, Gradle, and JVM failures in CI - resolved. GoGo build, module, and test failures - diagnosed. RustCargo and toolchain failures in CI - fixed.