Referencia de errores

La siguiente referencia es una lista completa de los errores que puedes encontrar al usar Astro. Para obtener asistencia adicional, incluidos los problemas comunes, consulta también nuestra Guía de solución de problemas.

Errores de Astro

• UnknownCompilerError
  Error de compilador desconocido.
• ClientAddressNotAvailable
  Astro.clientAddress no está disponible en el adaptador actual.
• PrerenderClientAddressNotAvailable
  Astro.clientAddress no se puede usar dentro de rutas prerenderizadas.
• StaticClientAddressNotAvailable
  Astro.clientAddress no está disponible en páginas prerenderizadas.
• NoMatchingStaticPathFound
  No se encontró una ruta estática para la ruta solicitada.
• OnlyResponseCanBeReturned
  Tipo no válido devuelto por la página de Astro.
• MissingMediaQueryDirective
  Falta el valor para la directiva client:media.
• NoMatchingRenderer
  No se encontró ningún renderizador coincidente.
• NoClientEntrypoint
  No se especificó ningún punto de entrada del cliente en el renderizador.
• NoClientOnlyHint
  Falta una indicación en la directiva client:only.
• InvalidGetStaticPathParam
  Valor no válido devuelto por una ruta desde getStaticPaths().
• InvalidGetStaticPathsEntry
  Entrada no válida dentro del valor devuelto de getStaticPaths().
• InvalidGetStaticPathsReturn
  Valor no válido devuelto por getStaticPaths().
• GetStaticPathsExpectedParams
  Falta la propiedad params en la ruta de getStaticPaths().
• GetStaticPathsInvalidRouteParam
  Parámetro de ruta no válido devuelto por getStaticPaths().
• GetStaticPathsRequired
  Se requiere la función getStaticPaths() para rutas dinámicas.
• ReservedSlotName
  Nombre de slot no válido.
• NoAdapterInstalled
  No se puede usar el renderizado del lado del servidor sin un adaptador.
• AdapterSupportOutputMismatch
  El adaptador no admite la salida del servidor.
• NoAdapterInstalledServerIslands
  No se pueden usar server islands sin un adaptador.
• NoMatchingImport
  No se encontró ninguna importación para el componente.
• InvalidPrerenderExport
  Exportación de prerenderizado no válida.
• InvalidComponentArgs
  Argumentos de componente no válidos.
• PageNumberParamNotFound
  No se encontró el parámetro de número de página.
• ImageMissingAlt
  A la imagen le falta la propiedad requerida "alt".
• InvalidImageService
  Error al cargar el servicio de imágenes.
• MissingImageDimension
  Faltan las dimensiones de la imagen.
• FailedToFetchRemoteImageDimensions
  Error al recuperar las dimensiones de la imagen remota.
• RemoteImageNotAllowed
  La imagen remota no está permitida.
• UnsupportedImageFormat
  Formato de imagen no soportado.
• UnsupportedImageConversion
  Conversión de imagen no soportada.
• CannotOptimizeSvg
  No se puede optimizar el SVG.
• PrerenderDynamicEndpointPathCollide
  El endpoint dinámico prerenderizado tiene una colisión de rutas.
• PrerenderRouteConflict
  La ruta prerenderizada genera la misma ruta que otra ruta.
• ExpectedImage
  Se esperaba que src fuera una imagen.
• ExpectedImageOptions
  Se esperaban opciones de imagen.
• ExpectedNotESMImage
  Se esperaban opciones de imagen, no una imagen importada por ESM.
• GetImageNotUsedOnServer
  getImage() debe ser usado en el servidor.
• IncompatibleDescriptorOptions
  No se pueden establecer tanto densities como widths.
• ImageNotFound
  Imagen no encontrada.
• NoImageMetadata
  No se pudieron procesar los metadatos de la imagen.
• CouldNotTransformImage
  No se pudo transformar la imagen.
• ResponseSentError
  No se pudo establecer la respuesta.
• MiddlewareNoDataOrNextCalled
  El middleware no devolvió una Response.
• MiddlewareNotAResponse
  El middleware devolvió algo que no es un objeto Response.
• EndpointDidNotReturnAResponse
  El endpoint no devolvió una Response.
• LocalsNotAnObject
  El valor asignado a locals no es aceptado.
• LocalsReassigned
  locals no debe ser reasignado.
• AstroResponseHeadersReassigned
  Astro.response.headers no debe ser reasignado.
• MiddlewareCantBeLoaded
  No se puede cargar el middleware.
• LocalImageUsedWrongly
  Las imágenes locales deben ser importadas.
• AstroGlobUsedOutside
  Astro.glob() usado fuera de un archivo Astro.
• AstroGlobNoMatch
  Astro.glob() no coincidió con ningún archivo.
• RedirectWithNoLocation
  A una redirección se le debe proporcionar una ubicación con la cabecera Location.
• UnsupportedExternalRedirect
  URL no soportada o mal formada.
• InvalidRedirectDestination
  Destino de redirección no válido.
• InvalidDynamicRoute
  Ruta dinámica no válida.
• MissingSharp
  No se pudo encontrar Sharp.
• UnknownViteError
  Error de Vite desconocido.
• FailedToLoadModuleSSR
  No se pudo importar el archivo.
• InvalidGlob
  Patrón glob no válido.
• FailedToFindPageMapSSR
  Astro no pudo encontrar la página correcta para renderizar.
• MissingLocale
  El locale proporcionado no existe.
• MissingIndexForInternationalization
  Página de inicio (index) no encontrada.
• IncorrectStrategyForI18n
  Función incompatible con la estrategia actual.
• NoPrerenderedRoutesWithDomains
  Las rutas prerenderizadas no son compatibles cuando los dominios de internacionalización están habilitados.
• MissingMiddlewareForInternationalization
  Se habilitó el enrutamiento manual de internacionalización sin tener un middleware.
• InvalidI18nMiddlewareConfiguration
  Configuración de middleware de internacionalización no válida.
• CantRenderPage
  Astro no puede renderizar la ruta.
• UnhandledRejection
  Rechazo no manejado (unhandled rejection).
• i18nNotEnabled
  El enrutamiento de internacionalización no está habilitado.
• i18nNoLocaleFoundInPath
  La ruta no contiene ningún locale.
• RouteNotFound
  Ruta no encontrada.
• EnvInvalidVariables
  Variables de entorno no válidas.
• EnvPrefixConflictsWithSecret
  envPrefix tiene conflictos con variables de entorno secretas.
• ServerOnlyModule
  El módulo solo está disponible en el lado del servidor.
• RewriteWithBodyUsed
  No se puede usar Astro.rewrite() después de que se haya leído el cuerpo de la solicitud (request body).
• ForbiddenRewrite
  Redirección interna (rewrite) prohibida a una ruta estática.
• UnknownFilesystemError
  Ocurrió un error desconocido al leer o escribir archivos en el disco.
• CannotExtractFontType
  No se puede extraer el tipo de fuente de la URL proporcionada.
• CannotDetermineWeightAndStyleFromFontFile
  No se puede determinar el peso y el estilo del archivo de fuente.
• CannotFetchFontFile
  No se puede recuperar el archivo de fuente proporcionado.
• FontFamilyNotFound
  Familia de fuentes no encontrada.
• FontFileUrlNotFound
  URL del archivo de fuente no encontrada.
• MissingGetFontFileRequestUrl
  experimental_getFontFileURL() requiere la URL de la solicitud con renderizado bajo demanda.
• UnavailableAstroGlobal
  Global de Astro no disponible en getStaticPaths().
• UnableToLoadLogger
  No se puede cargar el registrador (logger).
• LoggerConfigurationNotSerializable
  La configuración del registrador (logger) no es serializable.

Errores de CSS

• UnknownCSSError
  Error de CSS desconocido.
• CSSSyntaxError
  Error de sintaxis CSS.

Errores de Markdown

• UnknownMarkdownError
  Error de Markdown desconocido.
• MarkdownFrontmatterParseError
  Error al analizar el frontmatter de Markdown.
• InvalidFrontmatterInjectionError
  Inyección de frontmatter no válida.
• MdxIntegrationMissingError
  Falta la integración de MDX.
• UnknownConfigError
  Error de configuración desconocido.
• ConfigNotFound
  Archivo de configuración especificado no encontrado.
• ConfigLegacyKey
  Configuración heredada (legacy) detectada.

Errores de CLI

• UnknownCLIError
  Error de CLI desconocido.
• GenerateContentTypesError
  Error al generar los tipos de contenido.

Errores de colecciones de contenido

• UnknownContentCollectionError
  Error de colección de contenido desconocido.
• RenderUndefinedEntryError
  Se intentó renderizar una entrada de colección de contenido no definida.
• GetEntryDeprecationError
  Uso no válido de la función getDataEntryById o getEntryBySlug.
• InvalidContentEntryFrontmatterError
  El frontmatter de la entrada de contenido no coincide con el esquema.
• InvalidContentEntryDataError
  Los datos de la entrada de contenido no coinciden con el esquema.
• LegacyContentConfigError
  Se encontró un archivo de configuración de contenido heredado (legacy).
• ContentCollectionMissingLoader
  Falta la definición del cargador (loader) en la colección de contenido.
• ContentCollectionInvalidType
  La colección de contenido tiene un campo type no válido.
• ContentLoaderReturnsInvalidId
  El cargador de contenido devolvió una entrada con un id no válido.
• ContentEntryDataError
  Los datos de la entrada de contenido no coinciden con el esquema.
• LiveContentConfigError
  Error en la configuración de contenido en vivo.
• ContentLoaderInvalidDataError
  Falta el ID de la entrada de contenido.
• InvalidContentEntrySlugError
  Slug de entrada de contenido no válido.
• ContentSchemaContainsSlugError
  El esquema de contenido no debe contener slug.
• MixedContentDataCollectionError
  El contenido y los datos no pueden estar en la misma colección.
• ContentCollectionTypeMismatchError
  La colección contiene entradas de un tipo diferente.
• DataCollectionEntryParseError
  Error al analizar la entrada de la colección de datos.
• DuplicateContentEntrySlugError
  Slug de entrada de contenido duplicado.
• UnsupportedConfigTransformError
  Transformación no soportada en la configuración de contenido.
• FileParserNotFound
  Analizador de archivos no encontrado.
• FileGlobNotSupported
  Los patrones glob no son compatibles en el cargador de archivos (file loader).

Errores de acciones

• ActionsWithoutServerOutputError
  Las acciones deben utilizarse con salida del servidor.
• ActionsReturnedInvalidDataError
  El manejador de la acción devolvió datos no válidos.
• ActionNotFoundError
  Acción no encontrada.
• ActionCalledFromServerError
  Acción llamada desde el servidor sin Astro.callAction().
• ActionsCantBeLoaded
  No se pueden cargar las acciones de Astro.

Errores de sesión

• SessionStorageInitError
  No se pudo inicializar el almacenamiento de sesión.
• SessionStorageSaveError
  No se pudieron guardar los datos de sesión.

Errores de caché

• CacheProviderNotFound
  Proveedor de caché no encontrado.
• CacheNotEnabled
  La caché no está habilitada.
• CacheQueryConfigConflict
  Conflicto en la configuración de la consulta de caché.