Error reference

The following reference is a complete list of the errors you may encounter while using Astro. For additional assistance, including common pitfalls, please also see our Troubleshooting Guide.

Astro Errors

Section titled Astro Errors

• UnknownCompilerError
  Unknown compiler error.
• ClientAddressNotAvailable
  Astro.clientAddress is not available in current adapter.
• PrerenderClientAddressNotAvailable
  Astro.clientAddress cannot be used inside prerendered routes.
• StaticClientAddressNotAvailable
  Astro.clientAddress is not available in static mode.
• NoMatchingStaticPathFound
  No static path found for requested path.
• OnlyResponseCanBeReturned
  Invalid type returned by Astro page.
• MissingMediaQueryDirective
  Missing value for client:media directive.
• NoMatchingRenderer
  No matching renderer found.
• NoClientEntrypoint
  No client entrypoint specified in renderer.
• NoClientOnlyHint
  Missing hint on client:only directive.
• InvalidGetStaticPathParam
  Invalid value returned by a getStaticPaths path.
• InvalidGetStaticPathsEntry
  Invalid entry inside getStaticPath’s return value
• InvalidGetStaticPathsReturn
  Invalid value returned by getStaticPaths.
• GetStaticPathsExpectedParams
  Missing params property on getStaticPaths route.
• GetStaticPathsInvalidRouteParam
  Invalid value for getStaticPaths route parameter.
• GetStaticPathsRequired
  getStaticPaths() function required for dynamic routes.
• ReservedSlotName
  Invalid slot name.
• NoAdapterInstalled
  Cannot use Server-side Rendering without an adapter.
• NoMatchingImport
  No import found for component.
• InvalidPrerenderExport
  Invalid prerender export.
• InvalidComponentArgs
  Invalid component arguments.
• PageNumberParamNotFound
  Page number param not found.
• ImageMissingAlt
  Image missing required “alt” property.
• InvalidImageService
  Error while loading image service.
• MissingImageDimension
  Missing image dimensions
• FailedToFetchRemoteImageDimensions
  Failed to retrieve remote image dimensions
• UnsupportedImageFormat
  Unsupported image format
• UnsupportedImageConversion
  Unsupported image conversion
• PrerenderDynamicEndpointPathCollide
  Prerendered dynamic endpoint has path collision.
• ExpectedImage
  Expected src to be an image.
• ExpectedImageOptions
  Expected image options.
• ExpectedNotESMImage
  Expected image options, not an ESM-imported image.
• IncompatibleDescriptorOptions
  Cannot set both densities and widths
• ImageNotFound
  Image not found.
• NoImageMetadata
  Could not process image metadata.
• CouldNotTransformImage
  Could not transform image.
• ResponseSentError
  Unable to set response.
• MiddlewareNoDataOrNextCalled
  The middleware didn’t return a Response.
• MiddlewareNotAResponse
  The middleware returned something that is not a Response object.
• EndpointDidNotReturnAResponse
  The endpoint did not return a Response.
• LocalsNotAnObject
  Value assigned to locals is not accepted.
• AstroResponseHeadersReassigned
  Astro.response.headers must not be reassigned.
• MiddlewareCantBeLoaded
  Can’t load the middleware.
• LocalImageUsedWrongly
  Local images must be imported.
• AstroGlobUsedOutside
  Astro.glob() used outside of an Astro file.
• AstroGlobNoMatch
  Astro.glob() did not match any files.
• RedirectWithNoLocation
  A redirect must be given a location with the Location header.
• InvalidDynamicRoute
  Invalid dynamic route.
• MissingSharp
  Could not find Sharp.
• UnknownViteError
  Unknown Vite Error.
• FailedToLoadModuleSSR
  Could not import file.
• InvalidGlob
  Invalid glob pattern.
• FailedToFindPageMapSSR
  Astro couldn’t find the correct page to render
• MissingLocale
  The provided locale does not exist.
• MissingIndexForInternationalization
  Index page not found.
• IncorrectStrategyForI18n
  You can’t use the current function with the current strategy
• NoPrerenderedRoutesWithDomains
  Prerendered routes aren’t supported when internationalization domains are enabled.
• MissingMiddlewareForInternationalization
  Enabled manual internationalization routing without having a middleware.
• CantRenderPage
  Astro can’t render the route.
• UnhandledRejection
  Unhandled rejection
• i18nNotEnabled
  i18n Not Enabled
• i18nNoLocaleFoundInPath
  The path doesn’t contain any locale
• RouteNotFound
  Route not found.
• EnvInvalidVariables
  Invalid Environment Variables
• EnvUnsupportedGetSecret
  Unsupported astro:env getSecret
• ServerOnlyModule
  Module is only available server-side
• RewriteWithBodyUsed
  Cannot use Astro.rewrite after the request body has been read
• UnknownFilesystemError
  An unknown error occurred while reading or writing files to disk.

CSS Errors

Section titled CSS Errors

• UnknownCSSError
  Unknown CSS Error.
• CSSSyntaxError
  CSS Syntax Error.

Markdown Errors

Section titled Markdown Errors

• UnknownMarkdownError
  Unknown Markdown Error.
• MarkdownFrontmatterParseError
  Failed to parse Markdown frontmatter.
• InvalidFrontmatterInjectionError
  Invalid frontmatter injection.
• MdxIntegrationMissingError
  MDX integration missing.
• UnknownConfigError
  Unknown configuration error.
• ConfigNotFound
  Specified configuration file not found.
• ConfigLegacyKey
  Legacy configuration detected.

CLI Errors

Section titled CLI Errors

• UnknownCLIError
  Unknown CLI Error.
• GenerateContentTypesError
  Failed to generate content types.

Content Collection Errors

Section titled Content Collection Errors

• UnknownContentCollectionError
  Unknown Content Collection Error.
• RenderUndefinedEntryError
  Attempted to render an undefined content collection entry.
• GetEntryDeprecationError
  Invalid use of getDataEntryById or getEntryBySlug function.
• InvalidContentEntryFrontmatterError
  Content entry frontmatter does not match schema.
• InvalidContentEntrySlugError
  Invalid content entry slug.
• ContentSchemaContainsSlugError
  Content Schema should not contain slug.
• MixedContentDataCollectionError
  Content and data cannot be in same collection.
• ContentCollectionTypeMismatchError
  Collection contains entries of a different type.
• DataCollectionEntryParseError
  Data collection entry failed to parse.
• DuplicateContentEntrySlugError
  Duplicate content entry slug.
• UnsupportedConfigTransformError
  Unsupported transform in content config.

Action Errors

Section titled Action Errors

• ActionsWithoutServerOutputError
  Actions must be used with server output.
• ActionsReturnedInvalidDataError
  Action handler returned invalid data.
• ActionNotFoundError
  Action not found.
• ActionCalledFromServerError
  Action unexpected called from the server.

Reference