apache/hadoop · error · RemoteFileChangedException

PRECONDITIONS_FAILED

PRECONDITIONS_FAILED

Error message

Constraints of request were unsatisfiable on %s. Version %s was unavailable

What it means

Error "Constraints of request were unsatisfiable on %s. Version %s was unavailable" thrown in apache/hadoop.

Source

Thrown at hadoop-tools/hadoop-aws/src/main/java/org/apache/hadoop/fs/s3a/impl/ChangeTracker.java:235

  }

  /**
   * Process an exception generated against the change policy.
   * If the exception indicates the file has changed, this method throws
   * {@code RemoteFileChangedException} with the original exception as the
   * cause.
   * @param e the exception
   * @param operation the operation performed when the exception was
   * generated (e.g. "copy", "read").
   * @throws RemoteFileChangedException if the remote file has changed.
   */
  public void processException(SdkException e, String operation) throws
      RemoteFileChangedException {
    if (e instanceof AwsServiceException) {
      AwsServiceException serviceException = (AwsServiceException)e;
      if (serviceException.statusCode() == SC_412_PRECONDITION_FAILED) {
        versionMismatches.versionMismatchError();
        throw new RemoteFileChangedException(uri, operation, String.format(
            RemoteFileChangedException.PRECONDITIONS_FAILED
                + " on %s."
                + " Version %s was unavailable",
            getSource(),
            getRevisionId()),
            serviceException);
      }
    }
  }

  /**
   * Process metadata response from server for validation against the change
   * policy.
   * @param metadata metadata returned from server
   * @param operation operation in progress
   * @throws PathIOException raised on failure
   * @throws RemoteFileChangedException if the remote file has changed.
   */

View on GitHub (pinned to 2add963021)

Solutions

1. The object version or etag changed between listing and read; retry the operation to pick up the current version.

When it happens

Trigger: Thrown at hadoop-tools/hadoop-aws/src/main/java/org/apache/hadoop/fs/s3a/impl/ChangeTracker.java:235 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/hadoop@2add963021 (2026-08-22). Data as JSON: /api/errors/59eea15ae528d227. Report an issue: GitHub.