Referencia de errores

La siguiente referencia es una lista completa de los errores que puedes encontrar al usar Astro. Para obtener asistencia adicional, incluyendo las preguntas frequentes, consulta nuestra Guía de solución de problemas.

Errores de Astro

Sección titulada Errores de 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
  Missing 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.
• 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

Errores de CSS

Sección titulada Errores de CSS

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

Errores de Markdown

Sección titulada Errores 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.

Errores de CLI

Sección titulada Errores de CLI

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

Errores de Colección de Contenido

Sección titulada Errores de Colección de Contenido

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