Error Codes

When developing your application with Vercel, you may encounter a variety of errors. They can reflect issues that happen with external providers such as domain services or internal problems at the level of your application's deployment or your usage of platform features.

For general error handling guidance, that covers dashboard related errors, see General Errors.

• BODY_NOT_A_STRING_FROM_FUNCTION

  Function502

• MIDDLEWARE_INVOCATION_FAILED

  Function500

• MIDDLEWARE_INVOCATION_TIMEOUT

  Function504

• EDGE_FUNCTION_INVOCATION_FAILED

  Function500

• EDGE_FUNCTION_INVOCATION_TIMEOUT

  Function504

• FUNCTION_INVOCATION_FAILED

  Function500

• FUNCTION_INVOCATION_TIMEOUT

  Function504

• FUNCTION_PAYLOAD_TOO_LARGE

  Function413

• FUNCTION_RESPONSE_PAYLOAD_TOO_LARGE

  Function500

• FUNCTION_RATE_LIMIT

  Function429

• NO_RESPONSE_FROM_FUNCTION

  Function502

• DEPLOYMENT_BLOCKED

  Deployment403

• DEPLOYMENT_PAUSED

  Deployment503

• DEPLOYMENT_DISABLED

  Deployment402

• DEPLOYMENT_NOT_FOUND

  Deployment404

• NOT_FOUND

  Deployment404

• DEPLOYMENT_DELETED

  Deployment410

• DEPLOYMENT_NOT_READY_REDIRECTING

  Deployment303

• INFINITE_LOOP_DETECTED

  Runtime508

• DNS_HOSTNAME_EMPTY

  DNS502

• DNS_HOSTNAME_NOT_FOUND

  DNS502

• DNS_HOSTNAME_RESOLVE_FAILED

  DNS502

• DNS_HOSTNAME_RESOLVED_PRIVATE

  DNS404

• DNS_HOSTNAME_SERVER_ERROR

  DNS502

• TOO_MANY_FORKS

  Routing502

• TOO_MANY_FILESYSTEM_CHECKS

  Routing502

• ROUTER_CANNOT_MATCH

  Routing502

• ROUTER_EXTERNAL_TARGET_CONNECTION_ERROR

  Routing502

• ROUTER_EXTERNAL_TARGET_ERROR

  Routing502

• ROUTER_TOO_MANY_HAS_SELECTIONS

  Routing502

• ROUTER_EXTERNAL_TARGET_HANDSHAKE_ERROR

  Routing502

• INVALID_REQUEST_METHOD

  Request405

• MALFORMED_REQUEST_HEADER

  Request400

• REQUEST_HEADER_TOO_LARGE

  Request431

• RESOURCE_NOT_FOUND

  Request404

• RANGE_END_NOT_VALID

  Request416

• RANGE_GROUP_NOT_VALID

  Request416

• RANGE_MISSING_UNIT

  Request416

• RANGE_START_NOT_VALID

  Request416

• RANGE_UNIT_NOT_SUPPORTED

  Request416

• TOO_MANY_RANGES

  Request416

• URL_TOO_LONG

  Request414

• INVALID_IMAGE_OPTIMIZE_REQUEST

  Image400

• OPTIMIZED_EXTERNAL_IMAGE_REQUEST_FAILED

  Image502

• OPTIMIZED_EXTERNAL_IMAGE_REQUEST_INVALID

  Image502

• OPTIMIZED_EXTERNAL_IMAGE_REQUEST_UNAUTHORIZED

  Image502

• OPTIMIZED_EXTERNAL_IMAGE_TOO_MANY_REDIRECTS

  Image502

• FALLBACK_BODY_TOO_LARGE

  Cache502

The following errors are related to the Vercel platform. If you encounter one of these errors, contact Vercel support.

• INTERNAL_EDGE_FUNCTION_INVOCATION_FAILED
• INTERNAL_EDGE_FUNCTION_INVOCATION_TIMEOUT
• INTERNAL_FUNCTION_INVOCATION_FAILED
• INTERNAL_FUNCTION_INVOCATION_TIMEOUT
• INTERNAL_FUNCTION_NOT_FOUND
• INTERNAL_FUNCTION_NOT_READY
• INTERNAL_DEPLOYMENT_FETCH_FAILED
• INTERNAL_UNARCHIVE_FAILED
• INTERNAL_UNEXPECTED_ERROR
• INTERNAL_ROUTER_CANNOT_PARSE_PATH
• INTERNAL_STATIC_REQUEST_FAILED
• INTERNAL_OPTIMIZED_IMAGE_REQUEST_FAILED
• INTERNAL_CACHE_ERROR
• INTERNAL_CACHE_KEY_TOO_LONG
• INTERNAL_CACHE_LOCK_FULL
• INTERNAL_CACHE_LOCK_TIMEOUT
• INTERNAL_MISSING_RESPONSE_FROM_CACHE
• INTERNAL_FUNCTION_THROTTLED
• INTERNAL_FUNCTION_SERVICE_UNAVAILABLE