错误参考

以下参考是你在使用 Astro 时可能遇到的错误的完整列表。如需其他帮助，包括常见陷阱，另请参阅我们的 故障排除指南。

¥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 错误

标题部分 Astro 错误

¥Astro Errors

• UnknownCompilerError
  未知编译器错误。

• ClientAddressNotAvailable
  Astro.clientAddress 在当前适配器中不可用。

• PrerenderClientAddressNotAvailable
  Astro.clientAddress 不能在预渲染的路由内使用。

• StaticClientAddressNotAvailable
  Astro.clientAddress 在预渲染页面中不可用。

• NoMatchingStaticPathFound
  未找到请求路径的静态路径。

• OnlyResponseCanBeReturned
  Astro 页面返回的类型无效。

• MissingMediaQueryDirective
  client:media 指令的值缺失。

• NoMatchingRenderer
  未找到匹配的渲染器。

• NoClientEntrypoint
  渲染器中未指定客户端入口点。

• NoClientOnlyHint
  client:only 指令上缺少提示。

• InvalidGetStaticPathParam
  getStaticPaths 路径返回的值无效。

• InvalidGetStaticPathsEntry
  getStaticPath 的返回值中的条目无效

• InvalidGetStaticPathsReturn
  getStaticPaths 返回的值无效。

• GetStaticPathsExpectedParams
  getStaticPaths 路由上缺少 params 属性。

• GetStaticPathsInvalidRouteParam
  getStaticPaths 路由参数的值无效。

• 动态路由需要 GetStaticPathsRequired
  getStaticPaths() 功能。

• ReservedSlotName
  无效的插槽名称。

• NoAdapterInstalled
  无法在没有适配器的情况下使用服务器端渲染。

• AdapterSupportOutputMismatch
  适配器不支持服务器输出。

• NoAdapterInstalledServerIslands
  如果没有适配器则无法使用服务器岛。

• NoMatchingImport
  未找到组件的导入。

• InvalidPrerenderExport
  无效的预渲染导出。

• InvalidComponentArgs
  无效的组件参数。

• PageNumberParamNotFound
  未找到页码参数。

• ImageMissingAlt
  Image 缺少必需的 “alt” 属性。

• InvalidImageService
  加载图片服务时出错。

• MissingImageDimension
  缺少图片尺寸

• FailedToFetchRemoteImageDimensions
  无法检索远程图片尺寸

• UnsupportedImageFormat
  不支持的图片格式

• UnsupportedImageConversion
  不支持的图片转换

• PrerenderDynamicEndpointPathCollide
  预渲染的动态端点有路径冲突。

• ExpectedImage
  预期 src 为图片。

• ExpectedImageOptions
  预期的图片选项。

• ExpectedNotESMImage
  预期的图片选项，而不是 ESM 导入的图片。

• IncompatibleDescriptorOptions
  无法同时设置 densities 和 widths

• ImageNotFound
  未找到图片。

• NoImageMetadata
  无法处理图片元数据。

• CouldNotTransformImage
  无法转换图片。

• ResponseSentError
  无法设置响应。

• MiddlewareNoDataOrNextCalled
  中间件未返回 Response。

• MiddlewareNotAResponse
  中间件返回的内容不是 Response 对象。

• EndpointDidNotReturnAResponse
  端点未返回 Response。

• LocalsNotAnObject
  不接受分配给 locals 的值。

• LocalsReassigned
  locals 不能重新分配。

• AstroResponseHeadersReassigned
  Astro.response.headers 不能重新分配。

• 无法初始化 SessionStorageInitError
  Session 存储。

• 无法保存 SessionStorageSaveError
  Session 数据。

• MiddlewareCantBeLoaded
  无法加载中间件。

• LocalImageUsedWrongly
  必须导入本地图片。

• AstroGlobUsedOutside
  Astro.glob() 在 Astro 文件之外使用。

• AstroGlobNoMatch
  Astro.glob() 与任何文件都不匹配。

• RedirectWithNoLocation
  必须为重定向指定一个带有 Location 标头的位置。

• InvalidDynamicRoute
  无效的动态路由。

• MissingSharp
  无法找到 Sharp。

• UnknownViteError
  未知 Vite 错误。

• FailedToLoadModuleSSR
  无法导入文件。

• InvalidGlob
  无效的 glob 模式。

• FailedToFindPageMapSSR
  Astro 找不到要渲染的正确页面

• MissingLocale
  提供的语言环境不存在。

• MissingIndexForInternationalization
  未找到索引页。

• IncorrectStrategyForI18n
  你不能将当前函数与当前策略一起使用

• NoPrerenderedRoutesWithDomains
  启用国际化域时不支持预渲染的路由。

• MissingMiddlewareForInternationalization
  启用手动国际化路由，无需中间件。

• CantRenderPage
  Astro 无法渲染路由。

• UnhandledRejection
  未处理的拒绝

• i18nNotEnabled
  i18n 未启用

• i18nNoLocaleFoundInPath
  路径不包含任何语言环境

• RouteNotFound
  未找到路由。

• EnvInvalidVariables
  无效的环境变量

• ServerOnlyModule
  模块仅在服务器端可用

• RewriteWithBodyUsed
  读取请求正文后无法使用 Astro.rewrite

• ForbiddenRewrite
  禁止重写为静态路由。

• UnknownFilesystemError
  读取或写入文件到磁盘时发生未知错误。

CSS 错误

标题部分 CSS 错误

¥CSS Errors

• UnknownCSSError
  未知 CSS 错误。

• CSSSyntaxError
  CSS 语法错误。

Markdown 错误

标题部分 Markdown 错误

¥Markdown Errors

• UnknownMarkdownError
  未知 Markdown 错误。

• MarkdownFrontmatterParseError
  无法解析 Markdown 前置内容。

• InvalidFrontmatterInjectionError
  无效的前置内容注入。

• MdxIntegrationMissingError
  MDX 集成缺失。

• UnknownConfigError
  未知配置错误。

• ConfigNotFound
  未找到指定的配置文件。

• ConfigLegacyKey
  检测到旧配置。

CLI 错误

标题部分 CLI 错误

¥CLI Errors

• UnknownCLIError
  未知 CLI 错误。

• GenerateContentTypesError
  无法生成内容类型。

内容收集错误

标题部分 内容收集错误

¥Content Collection Errors

• UnknownContentCollectionError
  未知内容收集错误。

• RenderUndefinedEntryError
  尝试渲染未定义的内容集合条目。

• GetEntryDeprecationError
  getDataEntryById 或 getEntryBySlug 函数的使用无效。

• InvalidContentEntryFrontmatterError
  内容条目前置内容与架构不匹配。

• InvalidContentEntryDataError
  内容条目数据与架构不匹配。

• ContentEntryDataError
  内容条目数据与架构不匹配。

• ContentLoaderInvalidDataError
  内容条目缺少 ID

• InvalidContentEntrySlugError
  无效的内容条目 slug。

• ContentSchemaContainsSlugError
  Content Schema 不应包含 slug。

• MixedContentDataCollectionError
  内容和数据不能位于同一集合中。

• ContentCollectionTypeMismatchError
  Collection 包含不同类型的条目。

• DataCollectionEntryParseError
  数据收集条目解析失败。

• DuplicateContentEntrySlugError
  重复的内容条目 slug。

• UnsupportedConfigTransformError
  内容配置中不支持转换。

操作错误

标题部分 操作错误

¥Action Errors

• ActionsWithoutServerOutputError
  必须将操作与服务器输出一起使用。

• ActionsReturnedInvalidDataError
  Action 处理程序返回无效数据。

• 未找到 ActionNotFoundError
  Action。

• ActionCalledFromServerError
  从服务器调用了意外操作。