What causes "404 Not Found" in eclipse-vertx/vert.x?

Verify the URL/path before retrying

404 Not Found

Error message

404 Not Found

What it means

Constant defining the 404 Not Found response expectation: applying expecting(SC_NOT_FOUND) makes a 404 response fail the request future (as exercised in HttpTest). 404 means the origin did not find the target resource; the 'message' is the reason reported on the failed future.

Source

Thrown at vertx-core/src/main/java/io/vertx/core/http/HttpResponseExpectation.java:170

  /**
   * 401 Unauthorized
   */
  HttpResponseExpectation SC_UNAUTHORIZED = status(401);

  /**
   * 402 Payment Required
   */
  HttpResponseExpectation SC_PAYMENT_REQUIRED = status(402);

  /**
   * 403 Forbidden
   */
  HttpResponseExpectation SC_FORBIDDEN = status(403);

  /**
   * 404 Not Found
   */
  HttpResponseExpectation SC_NOT_FOUND = status(404);

  /**
   * 405 Method Not Allowed
   */
  HttpResponseExpectation SC_METHOD_NOT_ALLOWED = status(405);

  /**
   * 406 Not Acceptable
   */
  HttpResponseExpectation SC_NOT_ACCEPTABLE = status(406);

  /**
   * 407 Proxy Authentication Required
   */
  HttpResponseExpectation SC_PROXY_AUTHENTICATION_REQUIRED = status(407);

  /**
   * 408 Request Timeout

View on GitHub (pinned to fb308bd8c3)

Solutions

Verify the URL/path before retrying
Treat 404 as an outcome: either use a custom expectation that accepts it or handle the failed future explicitly

Defensive patterns

Strategy: try-catch

When it happens

Trigger: Thrown at vertx-core/src/main/java/io/vertx/core/http/HttpResponseExpectation.java:170 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of eclipse-vertx/vert.x@fb308bd8c3 (2026-09-06). Data as JSON: /api/errors/a4e26596fbda97ad. Report an issue: GitHub.