Reference
Error Codes
Use this guide to find specific solutions and insights for common Vercel errors.Table of Contents
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
Function502MIDDLEWARE_INVOCATION_FAILED
Function500MIDDLEWARE_INVOCATION_TIMEOUT
Function504EDGE_FUNCTION_INVOCATION_FAILED
Function500EDGE_FUNCTION_INVOCATION_TIMEOUT
Function504FUNCTION_INVOCATION_FAILED
Function500FUNCTION_INVOCATION_TIMEOUT
Function504FUNCTION_PAYLOAD_TOO_LARGE
Function413FUNCTION_RESPONSE_PAYLOAD_TOO_LARGE
Function500FUNCTION_RATE_LIMIT
Function429NO_RESPONSE_FROM_FUNCTION
Function502DEPLOYMENT_BLOCKED
Deployment403DEPLOYMENT_PAUSED
Deployment503DEPLOYMENT_DISABLED
Deployment402DEPLOYMENT_NOT_FOUND
Deployment404NOT_FOUND
Deployment404DEPLOYMENT_DELETED
Deployment410DEPLOYMENT_NOT_READY_REDIRECTING
Deployment303INFINITE_LOOP_DETECTED
Runtime508DNS_HOSTNAME_EMPTY
DNS502DNS_HOSTNAME_NOT_FOUND
DNS502DNS_HOSTNAME_RESOLVE_FAILED
DNS502DNS_HOSTNAME_RESOLVED_PRIVATE
DNS404DNS_HOSTNAME_SERVER_ERROR
DNS502TOO_MANY_FORKS
Routing502TOO_MANY_FILESYSTEM_CHECKS
Routing502ROUTER_CANNOT_MATCH
Routing502ROUTER_EXTERNAL_TARGET_CONNECTION_ERROR
Routing502ROUTER_EXTERNAL_TARGET_ERROR
Routing502ROUTER_TOO_MANY_HAS_SELECTIONS
Routing502ROUTER_EXTERNAL_TARGET_HANDSHAKE_ERROR
Routing502INVALID_REQUEST_METHOD
Request405MALFORMED_REQUEST_HEADER
Request400REQUEST_HEADER_TOO_LARGE
Request431RESOURCE_NOT_FOUND
Request404RANGE_END_NOT_VALID
Request416RANGE_GROUP_NOT_VALID
Request416RANGE_MISSING_UNIT
Request416RANGE_START_NOT_VALID
Request416RANGE_UNIT_NOT_SUPPORTED
Request416TOO_MANY_RANGES
Request416URL_TOO_LONG
Request414INVALID_IMAGE_OPTIMIZE_REQUEST
Image400OPTIMIZED_EXTERNAL_IMAGE_REQUEST_FAILED
Image502OPTIMIZED_EXTERNAL_IMAGE_REQUEST_INVALID
Image502OPTIMIZED_EXTERNAL_IMAGE_REQUEST_UNAUTHORIZED
Image502OPTIMIZED_EXTERNAL_IMAGE_TOO_MANY_REDIRECTS
Image502FALLBACK_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
Last updated on July 24, 2024
Was this helpful?