错误参考
下面是一张完整的错误列表,包含了你在使用 Astro 时可能遇到的所有报错。如需其他帮助(包括常见问题),另请参阅我们的故障排除指南。
Astro 错误
段落标题 Astro 错误- UnknownCompilerError
Unknown compiler error. - ClientAddressNotAvailable
Astro.clientAddress
is not available in current adapter. - PrerenderClientAddressNotAvailable
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 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. - 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 - 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 bothdensities
andwidths
- 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 aResponse
. - MiddlewareNotAResponse
The middleware returned something that is not aResponse
object. - EndpointDidNotReturnAResponse
The endpoint did not return aResponse
. - LocalsNotAnObject
Value assigned tolocals
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 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 - 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
Cannot use Astro.rewrite after the request body has been read - UnknownFilesystemError
An unknown error occurred while reading or writing files to disk.
CSS 错误
段落标题 CSS 错误- UnknownCSSError
Unknown CSS Error. - CSSSyntaxError
CSS Syntax Error.
Markdown 错误
段落标题 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.
CLI 错误
段落标题 CLI 错误- UnknownCLIError
Unknown CLI Error. - GenerateContentTypesError
Failed to generate content types.
内容集合错误
段落标题 内容集合错误- UnknownContentCollectionError
Unknown Content Collection Error. - GetEntryDeprecationError
Invalid use ofgetDataEntryById
orgetEntryBySlug
function. - InvalidContentEntryFrontmatterError
Content entry frontmatter does not match schema. - InvalidContentEntrySlugError
Invalid content entry slug. - ContentSchemaContainsSlugError
Content Schema should not containslug
. - 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.
Action 错误
段落标题 Action 错误- 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.