Error reference
이 컨텐츠는 아직 번역되지 않았습니다.
The following reference is a complete list of the errors you may encounter while using Astro. For additional assistance, including common pitfalls, please also see our Troubleshooting Guide.
Astro Errors
Section titled Astro Errors- 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 forclient:media
directive. - NoMatchingRenderer
No matching renderer found. - NoClientEntrypoint
No client entrypoint specified in renderer. - NoClientOnlyHint
Missing hint onclient:only
directive. - InvalidGetStaticPathParam
Invalid value returned by agetStaticPaths
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 ongetStaticPaths
route. - GetStaticPathsInvalidRouteParam
Invalid value forgetStaticPaths
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 - 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 bothdensities
andwidths
- 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 aResponse
. - MiddlewareNotAResponse
The middleware returned something that is not aResponse
object. - LocalsNotAnObject
Value assigned tolocals
is not accepted. - 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 theLocation
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
CSS Errors
Section titled CSS Errors- UnknownCSSError
Unknown CSS Error. - CSSSyntaxError
CSS Syntax Error.
Markdown Errors
Section titled Markdown Errors- 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.
CLI Errors
Section titled CLI Errors- UnknownCLIError
Unknown CLI Error. - GenerateContentTypesError
Failed to generate content types.
Content Collection Errors
Section titled Content Collection Errors- UnknownContentCollectionError
Unknown Content Collection Error. - InvalidContentEntryFrontmatterError
Content entry frontmatter does not match schema. - InvalidContentEntrySlugError
Invalid content entry slug. - ContentSchemaContainsSlugError
Content Schema should not containslug
. - 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.