Dokumentation

Avbrott i RDE-tjänsten efter AEM-driftsättning på grund av att OSGi-paket saknas

Last update: Fri Nov 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Distribuering av kod till Adobe Experience Manager as a Cloud Service (AEMaaCS) RDE-miljön orsakar ett tjänstavbrott när OSGi-paket från tredje part som io.jsonwebtoken inte kan matchas på grund av begränsningar i API-regionen. Du åtgärdar detta genom att bädda in de JAR-filer som krävs i projektet med Bundle-ClassPath eller -conditionalpackage, omdistribuera med aio aem:rde:install och verifiera att alla beroenden fungerar.

Beskrivning description

Miljö

  • Produkt: Adobe Experience Manager as a Cloud Service (AEMaaCS) - Webbplatser
  • Kontext: RDE (Rapid Development Environment)
  • Verktyg: aio aem:rde:install-kommando för distribution

Obs! Standardinstanser i molnet och lokala distributioner påverkas inte.

Problem/symtom

  • RDE-miljön slutar svara efter distributionen med aio aem:rde:install.

  • Instansen visar ett meddelande om serviceavgång.

  • Problemet kan inte lösas om du startar om eller återställer instansen.

  • Felloggar visar olösta OSGi-paketberoenden för io.jsonwebtoken från tredje part.

  • Beroenden löses i lokala och vanliga molnmiljöer men misslyckas i RDE på grund av striktare begränsningar för API-regioner.

  • Utdrag från felloggen:

    Unable to resolve fpaec-aem-base-components.core 645: missing requirement fpaec-aem-base-components.core [ 645] osgi.wiring.package; (&(osgi.wiring.package=io.jsonwebtoken)(version>=0.11.0)(!(version>=1.0.0)))

Upplösning resolution

Följ de här stegen för att åtgärda problemet:

  1. Granska begränsningar för API-regioner som upprätthålls av RDE. Dessa begränsningar begränsar paketsynlighet och blockerar åtkomst till tredjepartspaket som io.jsonwebtoken.

  2. Bädda in nödvändiga tredjepartsbibliotek i ditt projekt. Använd antingen -conditionalpackage eller Bundle-ClassPath för att inkludera följande JAR-filer:

    • lib/jjwt-api-0.11.2.jar
    • lib/jjwt-impl-0.11.2.jar
    • lib/jjwt-jackson-0.11.2.jar

  3. Lägg till följande instruktioner i din bnd.bnd-fil:

    code language-none 
    Bundle-ClassPath: .,
  lib/jjwt-api-0.11.2.jar,
  lib/jjwt-impl-0.11.2.jar,
  lib/jjwt-jackson-0.11.2.jar
    code language-none 
    -conditionalpackage: \
  io.jsonwebtoken;version="0.11.2", \
  io.jsonwebtoken.security;version="0.11.2"

  4. Distribuera det uppdaterade paketet med aio aem:rde:install. Bekräfta att alla beroenden har lösts och att tjänstavbrott inte längre inträffar.

  5. Testa driftsättningen i både utvecklings- och publiceringsmiljöer för att säkerställa stabilitet.

Relaterad läsning

Så här använder du Rapid Development Environment i AEM

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f