Referência de Erros

A referência a seguir é uma lista completa dos erros que você pode encontrar enquanto utiliza Astro. Para mais ajuda, incluindo pegadinhas comuns, por favor também veja nosso Guia de Solução de Problemas.

Erros do Astro

Seção intitulada Erros do Astro

• UnknownCompilerError
  Unknown compiler error.
• StaticRedirectNotAvailable
  Astro.redirect is not available in static mode.
• ClientAddressNotAvailable
  Astro.clientAddress is not available in current adapter.
• 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.
• GetStaticPathsRemovedRSSHelper
  getStaticPaths RSS helper is not available anymore.
• 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.
• IncompatibleDescriptorOptions
  Cannot set both densities and widths
• ImageNotFound
  Image not found.
• NoImageMetadata
  Could not process image metadata.
• MarkdownImageNotFound
  Image not found.
• 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.
• NoPrerenderedRoutesWithDomains
  Prerendered routes aren’t supported when internationalization domains are enabled.
• CantRenderPage
  Astro can’t render the route.
• UnhandledRejection
  Unhandled rejection
• i18nNotEnabled
  i18n Not Enabled

Erros de CSS

Seção intitulada Erros de CSS

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

Erros de Markdown

Seção intitulada Erros de Markdown

• 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.

Erros da CLI

Seção intitulada Erros da CLI

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

Erros de Coleções de Conteúdo

Seção intitulada Erros de Coleções de Conteúdo

• UnknownContentCollectionError
  Unknown Content Collection Error.
• InvalidContentEntryFrontmatterError
  Content entry frontmatter does not match schema.
• InvalidContentEntrySlugError
  Invalid content entry slug.
• ContentSchemaContainsSlugError
  Content Schema should not contain slug.
• CollectionDoesNotExistError
  Collection does not exist
• 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.