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

• 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 (EN)
  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
  Missing alt property.
• InvalidImageService
  Error while loading image service.
• MissingImageDimension
  Missing 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.
• ResponseSentError
  Unable to set response.
• MiddlewareNoDataOrNextCalled (EN)
  The middleware didn’t return a response or call next.
• MiddlewareNotAResponse (EN)
  The middleware returned something that is not a Response object.
• LocalImageUsedWrongly
  ESM imported images must be passed as-is.
• LocalsNotAnObject (EN)
  Value assigned to locals is not accepted.
• AstroGlobUsedOutside (EN)
  Astro.glob() used outside of an Astro file.
• AstroGlobNoMatch (EN)
  Astro.glob() did not match any files.
• RedirectWithNoLocation (EN)
  A redirect must be given a location with the Location header.
• InvalidDynamicRoute (EN)
  Invalid dynamic route.
• MissingSharp (EN)
  Could not find Sharp.
• UnknownViteError
  Unknown Vite Error.
• FailedToLoadModuleSSR
  Could not import file.
• InvalidGlob
  Invalid glob pattern.
• FailedToFindPageMapSSR (EN)
  Astro couldn’t find the correct page to render

Erros de CSS

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

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

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

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 (EN)
  Collection does not exist
• MixedContentDataCollectionError (EN)
  Content and data cannot be in same collection.
• ContentCollectionTypeMismatchError (EN)
  Collection contains entries of a different type.
• DataCollectionEntryParseError (EN)
  Data collection entry failed to parse.
• DuplicateContentEntrySlugError (EN)
  Duplicate content entry slug.
• UnsupportedConfigTransformError (EN)
  Unsupported transform in content config.