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

• 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 prerendered pages.
• 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 route parameter returned by getStaticPaths().
• GetStaticPathsRequired
  getStaticPaths() function required for dynamic routes.
• ReservedSlotName
  Invalid slot name.
• NoAdapterInstalled
  Cannot use Server-side Rendering without an adapter.
• AdapterSupportOutputMismatch
  Adapter does not support server output.
• NoAdapterInstalledServerIslands
  Cannot use Server Islands 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
• RemoteImageNotAllowed
  Remote image is not allowed
• UnsupportedImageFormat
  Unsupported image format
• UnsupportedImageConversion
  Unsupported image conversion
• CannotOptimizeSvg
  Cannot optimize SVG
• PrerenderDynamicEndpointPathCollide
  Prerendered dynamic endpoint has path collision.
• PrerenderRouteConflict
  Prerendered route generates the same path as another route.
• ExpectedImage
  Expected src to be an image.
• ExpectedImageOptions
  Expected image options.
• ExpectedNotESMImage
  Expected image options, not an ESM-imported image.
• GetImageNotUsedOnServer
  getImage() must be used on the server.
• 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.
• LocalsReassigned
  locals must not be reassigned.
• 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.
• UnsupportedExternalRedirect
  Unsupported or malformed URL.
• InvalidRedirectDestination
  Invalid redirect destination.
• 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.
• InvalidI18nMiddlewareConfiguration
  Invalid internationalization middleware configuration
• 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
• EnvPrefixConflictsWithSecret
  envPrefix conflicts with secret environment variables
• ServerOnlyModule
  Module is only available server-side
• RewriteWithBodyUsed
  Cannot use Astro.rewrite after the request body has been read
• ForbiddenRewrite
  Forbidden rewrite to a static route.
• UnknownFilesystemError
  An unknown error occurred while reading or writing files to disk.
• CannotExtractFontType
  Cannot extract the font type from the given URL.
• CannotDetermineWeightAndStyleFromFontFile
  Cannot determine weight and style from font file.
• CannotFetchFontFile
  Cannot fetch the given font file.
• FontFamilyNotFound
  Font family not found
• UnavailableAstroGlobal
  Unavailable Astro global in getStaticPaths()

CSS Errors

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

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

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

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.
• InvalidContentEntryDataError
  Content entry data does not match schema.
• LegacyContentConfigError
  Legacy content config file found.
• ContentCollectionMissingLoader
  Content collection is missing a loader definition.
• ContentCollectionInvalidType
  Content collection has an invalid type field.
• ContentLoaderReturnsInvalidId
  Content loader returned an entry with an invalid id.
• ContentEntryDataError
  Content entry data does not match schema.
• LiveContentConfigError
  Error in live content config.
• ContentLoaderInvalidDataError
  Content entry is missing an ID
• 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.
• FileParserNotFound
  File parser not found
• FileGlobNotSupported
  Glob patterns are not supported in the file loader

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.
• ActionsCantBeLoaded
  Can't load the Astro actions.

Session Errors

• SessionStorageInitError
  Session storage could not be initialized.
• SessionStorageSaveError
  Session data could not be saved.

Cache Errors

• CacheProviderNotFound
  Cache provider not found.
• CacheNotEnabled
  Cache is not enabled.
• CacheQueryConfigConflict
  Conflicting cache query configuration.