오류 참조

다음 참조는 Astro를 사용하는 동안 발생할 수 있는 오류의 전체 목록입니다. 일반적인 문제를 포함한 추가 지원이 필요하면 문제 해결 가이드도 참조하세요.

Astro 오류

• CantUseAstroConfigModuleError
  실험적 기능을 활성화하지 않으면 astro:config 모듈을 사용할 수 없습니다.
• 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 경로에 매개변수 속성이 누락되었습니다.
• GetStaticPathsInvalidRouteParam
  getStaticPaths()에서 반환된 잘못된 라우트 매개변수입니다.
• GetStaticPathsRequired
  동적 경로에는 getStaticPaths() 함수가 필요합니다.
• ReservedSlotName
  슬롯 이름이 잘못되었습니다.
• NoAdapterInstalled
  어댑터 없이는 서버 측 렌더링을 사용할 수 없습니다.
• AdapterSupportOutputMismatch
  어댑터가 서버 출력을 지원하지 않습니다.
• NoAdapterInstalledServerIslands
  어댑터 없이 서버 아일랜드를 사용할 수 없습니다.
• NoMatchingImport
  컴포넌트에 대한 가져오기를 찾을 수 없습니다.
• InvalidPrerenderExport
  사전 렌더링 내보내기가 잘못되었습니다.
• InvalidComponentArgs
  컴포넌트 인수가 잘못되었습니다.
• PageNumberParamNotFound
  페이지 번호 매개변수를 찾을 수 없습니다.
• ImageMissingAlt
  이미지에 필수 "alt" 속성이 누락되었습니다.
• InvalidImageService
  이미지 서비스를 로드하는 중 오류가 발생했습니다.
• MissingImageDimension
  이미지 크기가 누락되었습니다.
• FailedToFetchRemoteImageDimensions
  원격 이미지 크기를 검색하지 못했습니다.
• RemoteImageNotAllowed
  원격 이미지는 허용되지 않습니다.
• UnsupportedImageFormat
  지원되지 않는 이미지 형식
• UnsupportedImageConversion
  지원되지 않는 이미지 변환
• CannotOptimizeSvg
  SVG를 최적화할 수 없습니다.
• PrerenderDynamicEndpointPathCollide
  사전 렌더링된 동적 엔드포인트에 경로 충돌이 있습니다.
• PrerenderRouteConflict
  사전 렌더링된 라우트가 다른 라우트와 동일한 경로를 생성합니다.
• ExpectedImage
  src는 이미지일 것으로 예상됩니다.
• ExpectedImageOptions
  예상되는 이미지 옵션.
• ExpectedNotESMImage
  ESM에서 가져온 이미지가 아닌 예상되는 이미지 옵션.
• GetImageNotUsedOnServer
  getImage()는 반드시 서버에서 사용되어야 합니다.
• IncompatibleDescriptorOptions
  densities 및 widths를 모두 설정할 수 없습니다.
• ImageNotFound
  이미지를 찾을 수 없습니다.
• NoImageMetadata
  이미지 메타데이터를 처리할 수 없습니다.
• CouldNotTransformImage
  이미지를 변환할 수 없습니다.
• ResponseSentError
  응답을 설정할 수 없습니다.
• MiddlewareNoDataOrNextCalled
  미들웨어가 Response를 반환하지 않았습니다.
• MiddlewareNotAResponse
  미들웨어가 Response 객체가 아닌 것을 반환했습니다.
• EndpointDidNotReturnAResponse
  엔드포인트가 Response를 반환하지 않았습니다.
• LocalsNotAnObject
  locals에 할당된 값은 허용되지 않습니다.
• LocalsReassigned
  locals에 재할당할 수 없습니다.
• AstroResponseHeadersReassigned
  Astro.response.headers는 재할당되어서는 안 됩니다.
• MiddlewareCantBeLoaded
  미들웨어를 로드할 수 없습니다.
• LocalImageUsedWrongly
  로컬 이미지를 가져와야 합니다.
• AstroGlobUsedOutside
  Astro.glob()은 Astro 파일 외부에서 사용됩니다.
• AstroGlobNoMatch
  Astro.glob()과 일치하는 파일이 없습니다.
• RedirectWithNoLocation
  리디렉션에는 Location 헤더가 있는 location이 제공되어야 합니다.
• UnsupportedExternalRedirect
  지원되지 않거나 잘못된 URL입니다.
• InvalidRedirectDestination
  유효하지 않은 리디렉션 대상입니다.
• InvalidDynamicRoute
  동적 경로가 잘못되었습니다.
• MissingSharp
  Sharp를 찾을 수 없습니다.
• UnknownViteError
  알 수 없는 Vite 오류입니다.
• FailedToLoadModuleSSR
  파일을 가져올 수 없습니다.
• InvalidGlob
  잘못된 glob 패턴입니다.
• FailedToFindPageMapSSR
  Astro가 렌더링할 올바른 페이지를 찾을 수 없습니다.
• MissingLocale
  제공된 언어가 존재하지 않습니다.
• MissingIndexForInternationalization
  색인 페이지를 찾을 수 없습니다.
• IncorrectStrategyForI18n
  현재 전략에는 현재 함수를 사용할 수 없습니다
• NoPrerenderedRoutesWithDomains
  국제화 도메인이 활성화된 경우 사전 렌더링된 경로는 지원되지 않습니다.
• MissingMiddlewareForInternationalization
  미들웨어 없이 수동 국제화 라우팅을 활성화했습니다.
• InvalidI18nMiddlewareConfiguration
  유효하지 않은 국제화 미들웨어 구성입니다.
• CantRenderPage
  Astro가 경로를 렌더링할 수 없습니다.
• UnhandledRejection
  처리될 수 없는 오류가 발생했습니다.
• i18nNotEnabled
  i18n이 활성화되지 않았습니다.
• i18nNoLocaleFoundInPath
  경로에 로케일이 포함되어 있지 않습니다.
• RouteNotFound
  경로를 찾을 수 없습니다.
• EnvInvalidVariables
  잘못된 환경 변수
• EnvPrefixConflictsWithSecret
  envPrefix가 비밀 환경 변수와 충돌합니다.
• ServerOnlyModule
  모듈은 서버 측에서만 사용할 수 있습니다.
• RewriteWithBodyUsed
  요청 본문을 읽은 후에는 Astro.rewrite를 사용할 수 없습니다.
• ForbiddenRewrite
  정적 라우트에서 리라이트는 금지되어 있습니다.
• UnknownFilesystemError
  디스크에 파일을 읽거나 쓰는 동안 알 수 없는 오류가 발생했습니다.
• CannotExtractFontType
  주어진 URL에서 글꼴 유형을 추출할 수 없습니다.
• CannotDetermineWeightAndStyleFromFontFile
  글꼴 파일에서 굵기와 스타일을 결정할 수 없습니다.
• CannotFetchFontFile
  제공된 글꼴 파일을 가져올 수 없습니다.
• FontFamilyNotFound
  글꼴 패밀리를 찾을 수 없습니다.
• UnavailableAstroGlobal
  getStaticPaths()에서 Astro 전역을 사용할 수 없습니다.

CSS 오류

• UnknownCSSError
  알 수 없는 CSS 오류입니다.
• CSSSyntaxError
  CSS 구문 오류.

Markdown 오류

• UnknownMarkdownError
  알 수 없는 Markdown 오류입니다.
• MarkdownFrontmatterParseError
  Markdown 프런트매터를 구문 분석하지 못했습니다.
• InvalidFrontmatterInjectionError
  잘못된 프론트매터 삽입입니다.
• MdxIntegrationMissingError
  MDX 통합이 누락되었습니다.
• UnknownConfigError
  알 수 없는 구성 오류입니다.
• ConfigNotFound
  지정된 구성 파일을 찾을 수 없습니다.
• ConfigLegacyKey
  레거시 구성이 감지되었습니다.

CLI 오류

• UnknownCLIError
  알 수 없는 CLI 오류.
• GenerateContentTypesError
  콘텐츠 타입을 생성하지 못했습니다.

콘텐츠 컬렉션 오류

• UnknownContentCollectionError
  알 수 없는 콘텐츠 컬렉션 오류입니다.
• RenderUndefinedEntryError
  정의되지 않은 콘텐츠 컬렉션 항목을 렌더링하려고 했습니다.
• GetEntryDeprecationError
  getDataEntryById 또는 getEntryBySlug 함수를 잘못 사용했습니다.
• InvalidContentEntryFrontmatterError
  콘텐츠 항목 프런트매터가 스키마와 일치하지 않습니다.
• InvalidContentEntryDataError
  콘텐츠 항목 데이터가 스키마와 일치하지 않습니다.
• LegacyContentConfigError
  레거시 콘텐츠 구성 파일이 존재합니다.
• ContentCollectionMissingLoader
  콘텐츠 컬렉션에 loader 정의가 없습니다.
• ContentCollectionInvalidType
  콘텐츠 컬렉션에 유효하지 않은 type 필드가 존재합니다.
• ContentLoaderReturnsInvalidId
  콘텐츠 로더가 유효하지 않은 id를 가진 항목을 반환했습니다.
• ContentEntryDataError
  콘텐츠 항목 데이터가 스키마와 일치하지 않습니다.
• LiveContentConfigError
  라이브 콘텐츠 구성에서 오류가 발생했습니다.
• ContentLoaderInvalidDataError
  콘텐츠 항목에 ID가 누락되었습니다.
• InvalidContentEntrySlugError
  잘못된 콘텐츠 항목 슬러그입니다.
• ContentSchemaContainsSlugError
  콘텐츠 스키마에는 slug가 포함되어서는 안 됩니다.
• MixedContentDataCollectionError
  콘텐츠와 데이터는 동일한 컬렉션에 포함될 수 없습니다.
• ContentCollectionTypeMismatchError
  컬렉션에 다른 타입의 항목이 포함되어 있습니다.
• DataCollectionEntryParseError
  데이터 컬렉션 항목을 구문 분석하지 못했습니다.
• DuplicateContentEntrySlugError
  콘텐츠 항목 슬러그가 중복되었습니다.
• UnsupportedConfigTransformError
  콘텐츠 구성에서 지원되지 않는 변환입니다.
• FileParserNotFound
  파일 구문 분석기를 찾을 수 없습니다.
• FileGlobNotSupported
  Glob 패턴은 파일 로더에서 지원되지 않습니다.

액션 오류

• ActionsWithoutServerOutputError
  액션은 서버 출력과 함께 사용해야 합니다.
• ActionsReturnedInvalidDataError
  액션 핸들러가 잘못된 데이터를 반환했습니다.
• ActionNotFoundError
  액션을 찾을 수 없습니다.
• ActionCalledFromServerError
  서버에서 예기치 않은 액션이 호출되었습니다.
• ActionsCantBeLoaded
  Astro 액션을 로드할 수 없습니다.

세션 오류

• SessionStorageInitError
  세션 스토리지를 초기화할 수 없습니다.
• SessionStorageSaveError
  세션 데이터를 저장할 수 없습니다.

캐시 오류

• CacheProviderNotFound
  캐시 공급자를 찾을 수 없습니다.
• CacheNotEnabled
  캐시가 활성화되지 않았습니다.
• CacheQueryConfigConflict
  캐시 쿼리 구성이 충돌합니다.