설명서Experience Cloud KCS

AEM as a Cloud Service: 사전 변경 후 i18n ResourceBundle 캐시가 업데이트되지 않음

마지막 업데이트: 2026년 8월 30일

Adobe Experience Manager as a Cloud Service에서 /conf 아래의 i18n 사전 파일에 대한 업데이트가 Sling ResourceBundle 캐시에 표시되지 않아 UI 레이블에 번역된 텍스트 대신 확인되지 않은 i18n 키가 표시될 수 있습니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service(AEMaaCS)(모든 버전)

문제/증상

  • /conf/.../i18n/en.json 또는 fr.json에서 새로 추가되거나 업데이트된 i18n 키가 JCR 저장소에 있지만 Sling ResourceBundle 캐시에 표시되지 않습니다.
  • UI 레이블에는 작성 환경에서 번역된 예상 텍스트 대신 원시 i18n 키(예: lblExampleKey)가 표시됩니다.
  • 클라이언트 라이브러리를 다시 빌드하거나 캐시를 무효화하려고 해도 문제가 해결되지 않습니다.

원인

/conf에서 오래되었거나 충돌하는 i18n 사전 파일로 인해 Sling ResourceBundle 캐시가 새 키로 업데이트되지 않을 수 있습니다. 그러면 확인되지 않은 UI 레이블이 발생합니다. 오래된 노드를 삭제하고 원하는 사전만 표시되도록 하면 캐시를 새로 고치고 올바른 번역을 표시할 수 있습니다.

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. /conf/<project>/i18n/en.json 및 fr.json과(와) 같이 /conf에서 사용되지 않거나 충돌하는 i18n 사전 파일을 식별하십시오.
  2. 삭제할 사용되지 않는 사전 파일을 대상으로 하는 필터 정의가 있는 FileVault 콘텐츠 패키지를 만듭니다. 제거할 각 사용되지 않는 사전 노드에 대해 mode="replace"을(를) 사용하고, 해당 경로에 대해 패키지 페이로드를 비워 두면 설치 시 지정된 노드가 리포지토리에서 제거됩니다.
  3. CI/CD 파이프라인을 통해 패키지를 작성자 환경에 배포합니다.
  4. 변경 사항을 게시 환경에 복제하여 모든 계층에 걸쳐 일관성을 보장합니다.
  5. /conf/<project>/i18n/en.json 및 fr.json과(와) 같은 오래된 사전 파일에 더 이상 액세스할 수 없는지 확인하고 직접 액세스할 경우 404 응답을 반환합니다.
  6. 이제 UI 레이블이 올바른 번역된 텍스트로 확인되는지 확인합니다.

메모

사전을 /apps(으)로 마이그레이션하는 경우 새 사전을 추가하고 이전 /conf 필터에서 바꾸기 모드를 사용하여 동일한 릴리스의 오래된 노드를 제거하는지 확인하십시오.

관련 읽기

구성 요소 및 응용 프로그램 다국어화

recommendation-more-help
experience-cloud-kcs-help-kbarticles