エラーリファレンス

以下のリファレンスは、Astroを使用している際に遭遇する可能性のあるエラーの完全なリストです。よくある落とし穴など、その他のサポートが必要であれば、トラブルシューティングガイドも参照してください。

Astroエラー

セクションタイトル： 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 (EN)
  Invalid slot name.
• NoAdapterInstalled (EN)
  Cannot use Server-side Rendering without an adapter.
• NoMatchingImport (EN)
  No import found for component.
• InvalidPrerenderExport (EN)
  Invalid prerender export.
• InvalidComponentArgs (EN)
  Invalid component arguments.
• PageNumberParamNotFound (EN)
  Page number param not found.
• ImageMissingAlt (EN)
  Missing alt property.
• InvalidImageService (EN)
  Error while loading image service.
• MissingImageDimension (EN)
  Missing image dimensions
• UnsupportedImageFormat (EN)
  Unsupported image format
• PrerenderDynamicEndpointPathCollide (EN)
  Prerendered dynamic endpoint has path collision.
• ExpectedImage (EN)
  Expected src to be an image.
• ExpectedImageOptions (EN)
  Expected image options.
• ImageNotFound (EN)
  Image not found.
• NoImageMetadata (EN)
  Could not process image metadata.
• MarkdownImageNotFound (EN)
  Image not found.
• ResponseSentError (EN)
  Unable to set response.
• MiddlewareNoDataOrNextCalled (EN)
  The middleware didn’t return a response or call next.
• MiddlewareNotAResponse (EN)
  The middleware returned something that is not a Response object.
• LocalsNotAnObject (EN)
  Value assigned to locals is not accepted.
• LocalImageUsedWrongly (EN)
  Local images must be imported.
• AstroGlobUsedOutside (EN)
  Astro.glob() used outside of an Astro file.
• AstroGlobNoMatch (EN)
  Astro.glob() did not match any files.
• RedirectWithNoLocation (EN)
  A redirect must be given a location with the Location header.
• InvalidDynamicRoute (EN)
  Invalid dynamic route.
• MissingSharp (EN)
  Could not find Sharp.
• UnknownViteError (EN)
  Unknown Vite Error.
• FailedToLoadModuleSSR (EN)
  Could not import file.
• InvalidGlob (EN)
  Invalid glob pattern.
• FailedToFindPageMapSSR (EN)
  Astro couldn’t find the correct page to render

CSSエラー

セクションタイトル： CSSエラー

• UnknownCSSError (EN)
  Unknown CSS Error.
• CSSSyntaxError (EN)
  CSS Syntax Error.

Markdownエラー

セクションタイトル： Markdownエラー

• UnknownMarkdownError (EN)
  Unknown Markdown Error.
• MarkdownFrontmatterParseError (EN)
  Failed to parse Markdown frontmatter.
• InvalidFrontmatterInjectionError (EN)
  Invalid frontmatter injection.
• MdxIntegrationMissingError (EN)
  MDX integration missing.
• UnknownConfigError (EN)
  Unknown configuration error.
• ConfigNotFound (EN)
  Specified configuration file not found.
• ConfigLegacyKey (EN)
  Legacy configuration detected.

CLIエラー

セクションタイトル： CLIエラー

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

コンテンツコレクションエラー

セクションタイトル： コンテンツコレクションエラー

• UnknownContentCollectionError (EN)
  Unknown Content Collection Error.
• InvalidContentEntryFrontmatterError (EN)
  Content entry frontmatter does not match schema.
• InvalidContentEntrySlugError (EN)
  Invalid content entry slug.
• ContentSchemaContainsSlugError (EN)
  Content Schema should not contain slug.
• CollectionDoesNotExistError (EN)
  Collection does not exist
• MixedContentDataCollectionError (EN)
  Content and data cannot be in same collection.
• ContentCollectionTypeMismatchError (EN)
  Collection contains entries of a different type.
• DataCollectionEntryParseError (EN)
  Data collection entry failed to parse.
• DuplicateContentEntrySlugError (EN)
  Duplicate content entry slug.
• UnsupportedConfigTransformError (EN)
  Unsupported transform in content config.