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 imprevistos comuns, veja também nosso Guia de Solução de Problemas.

Erros do Astro

Seção intitulada Erros do Astro

• UnknownCompilerError
  Unknown compiler error.
• ClientAddressNotAvailable
  Astro.clientAddress is not available in current adapter.
• PrerenderClientAddressNotAvailable (EN)
  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 (EN)
  Cannot use Astro.rewrite after the request body has been read
• UnknownFilesystemError
  An unknown error occurred while reading or writing files to disk.

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

Erros de Ações

Seção intitulada Erros de Ações

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