RepoFlow Error Knowledge Base

Maven cannot map a short plugin prefix (like `spring-boot`) to an actual plugin artifact, usually because the plugin isn't available from configured plugin repositories or isn't declared in the build.

Code: PLUGIN_RESOLUTION_FAILURE

Plugin ... or one of its dependencies could not be resolved

Maven cannot download a build plugin (or its transitive dependencies) from configured plugin repositories.

Code: LOCAL_REPOSITORY_PERMISSION_DENIED

Could not create local repository

Maven cannot write to the local repository directory (`~/.m2/repository` by default), usually due to permissions or a read-only filesystem.

Code: CHECKSUM_VALIDATION_FAILED

Checksum validation failed

Maven downloaded an artifact, but its checksum did not match (or the repository did not provide expected checksums), indicating corruption or repository/proxy issues.

Code: DEFAULT_HTTP_BLOCKER

Blocked mirror for repositories (maven-default-http-blocker)

Maven refused to use an insecure HTTP repository URL and blocked the request using the built-in `maven-default-http-blocker` mirror.

Code: POM_MISSING

The POM for <artifact> is missing, no dependency information available

Maven located a JAR coordinate, but could not download the corresponding POM, so it cannot determine transitive dependencies or metadata for that artifact.

Code: UNKNOWN_HOST_EXCEPTION

UnknownHostException while downloading dependencies

The machine running Maven could not resolve the repository hostname via DNS, so Maven cannot download artifacts or metadata.

Code: SSL_HANDSHAKE_FAILURE

SSLHandshakeException: Received fatal alert: handshake_failure

The JVM running Maven could not complete the TLS handshake with the repository, so Maven cannot download artifacts over HTTPS.

Code: OFFLINE_MODE

Cannot access <repository> in offline mode

Maven is running with offline mode enabled (`-o` / `--offline`), so it will not contact remote repositories to download missing artifacts.

Code: COMMAND_NOT_FOUND

bash: pip: command not found

Your shell can't find a `pip` executable on `PATH` (or you're using an environment where `pip` is intentionally not installed).

Code: WINDOWS_NOT_RECOGNIZED

'pip' is not recognized as an internal or external command, operable program or batch file.

On Windows, `cmd.exe`/PowerShell can't find `pip.exe` on PATH (or you're using the wrong Python install).

Code: EXTERNALLY_MANAGED_ENVIRONMENT

error: externally-managed-environment

Your OS Python is marked as "externally managed" (PEP 668), so pip refuses to modify the system environment outside a virtual environment.

Code: NO_MODULE_NAMED_PIP

ModuleNotFoundError: No module named 'pip'

The Python interpreter you're running does not have pip installed (or the environment is broken/corrupted).

Code: UNKNOWN_COMMAND

ERROR: unknown command "update" (and "upgrade")

pip does not have `update` or `upgrade` subcommands. Upgrading packages is done with `pip install --upgrade ...`.

Code: NO_REQUIREMENT_GIVEN

ERROR: You must give at least one requirement to install (see "pip help install")

You ran `pip install` without specifying a package name, a file/path, or `-r requirements.txt`.

Code: OLD_SCRIPT_WRAPPER

WARNING: pip is being invoked by an old script wrapper. This will fail in a future version of pip.

You're running pip through an outdated entrypoint script. It still works today, but it can break after pip upgrades.

Code: REQUIREMENTS_FILE_NOT_FOUND

ERROR: Could not open requirements file: [Errno 2] No such file or directory: 'requirements.txt'

pip was asked to install from a requirements file path that does not exist (wrong filename, wrong directory, or missing checkout).

Code: INVALID_REQUIREMENT

ERROR: Invalid requirement: ... (requirement spec parse error)

pip could not parse a requirement specifier (malformed version constraint, quotes/smart-quotes, comments, or an invalid line in a requirements file).

Code: DIRECTORY_NOT_INSTALLABLE

ERROR: Directory '.' is not installable. Neither 'setup.py' nor 'pyproject.toml' found.

You asked pip to install from a local directory or sdist, but it doesn't contain standard Python packaging metadata (`pyproject.toml` or `setup.py`).

Code: NO_MATCHING_DISTRIBUTION

ERROR: No matching distribution found (and "Could not find a version that satisfies the requirement")

pip could not find any installable release that matches your requirement and your environment (Python version, OS/architecture, and index configuration).

Code: REQUIRES_PYTHON_MISMATCH

ERROR: Package '<pkg>' requires a different Python ... (Requires-Python mismatch)

The package (or one of its dependencies) declares a `Requires-Python` range that excludes the Python interpreter you're using.

Code: DEPENDENCY_CONFLICT

ERROR: ResolutionImpossible (conflicting dependencies)

pip's resolver could not find any set of versions that satisfies all constraints at the same time.

Code: INSTALLED_PACKAGES_CONFLICT

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed.

Your environment is already inconsistent. pip installed or upgraded something, but the full installed set now contains version conflicts.

Code: SUBPROCESS_EXITED_WITH_ERROR

error: subprocess-exited-with-error

pip delegated part of the install to an external build step (PEP 517 backend or legacy `setup.py`) and that subprocess failed.

Code: FAILED_TO_BUILD_WHEELS

ERROR: Failed to build installable wheels for some pyproject.toml based projects

pip attempted to build a wheel from a PEP 517 project, but the wheel build failed and pip cannot install it without a wheel.

Code: BUILD_TOOLCHAIN_MISSING

Build toolchain missing (gcc / Python.h / MSVC / Rust)

pip is building a package from source, but your system is missing a required toolchain (C/C++ compiler, Python headers, MSVC Build Tools, or Rust).

Code: PERMISSION_DENIED

ERROR: Could not install packages due to an OSError: [Errno 13] Permission denied

pip tried to write into a directory you don't have permission to modify (often system site-packages or a protected install directory).

Code: NO_SPACE_LEFT_ON_DEVICE

Could not install packages due to an EnvironmentError: [Errno 28] No space left on device

The machine ran out of disk space while pip was downloading/building/installing packages (often in the temp directory or cache).

Code: CACHE_DIR_NOT_OWNED

The directory '.../.cache/pip/...' is not owned by the current user and the cache has been disabled.

pip detected that its cache directory is owned by a different user (often because pip was previously run with `sudo`), so it disables caching for safety.

Code: SSL_MODULE_NOT_AVAILABLE

pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.

Your Python was built or installed without SSL support, so pip cannot make HTTPS requests to package indexes like PyPI.

Code: NETWORK_RETRIES_TIMEOUTS

WARNING: Retrying (...) after connection broken by ... (timeouts / proxy / SSL negotiation)

pip is repeatedly failing to reach the package index due to network timeouts, proxy issues, or TLS incompatibilities, and it is retrying until it gives up.

Code: HASH_MISMATCH

ERROR: THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE.

You are using hash-checking mode (`--require-hashes`), but the downloaded file's hash doesn't match, or some requirements are missing hashes.

Code: RECORD_FILE_NOT_FOUND

ERROR: Cannot uninstall <pkg>, RECORD file not found.

pip cannot uninstall a package because it cannot find the installed-files manifest (`RECORD`) in the package metadata.

Code: DISTUTILS_UNINSTALL_BLOCKED

ERROR: Cannot uninstall '<pkg>'. It is a distutils installed project ...

pip refuses to uninstall a package that was installed via distutils/OS tooling without reliable metadata, because it can't safely determine which files to remove.

Code: CACHE_DESERIALIZATION_FAILED

Cache entry deserialization failed, entry ignored

pip detected a corrupted or incompatible cache entry and ignored it. Installs may be slower or may fail if corruption is widespread.