DocumentazioneExperience Cloud KCS

Risoluzione degli errori di distribuzione di AEM Cloud Manager causati da errori del componente OSGi personalizzato

Ultimo aggiornamento: 3 settembre 2026

Questo articolo descrive come risolvere i problemi relativi agli errori della pipeline di distribuzione in Adobe Experience Manager (AEM) Cloud Manager quando non viene creata un’istanza dei componenti OSGi personalizzati, creando ambienti instabili e messaggi di registro non chiari.

Descrizione description

Ambiente

Adobe Experience Manager (AEM) as a Cloud Service, implementato tramite pipeline Cloud Manager

Sintomi

  • Le pipeline di distribuzione hanno esito negativo e le nuove distribuzioni non raggiungono uno stato stabile.

  • Le istanze dell’applicazione vengono riavviate frequentemente e non sono pronte.

  • I controlli di integrità non riescono, inclusa la verifica dei percorsi obbligatori (ad esempio: /libs/granite/security/currentuser.json restituisce HTTP 503) e Componenti obbligatori (personalizzati) segnala i componenti non soddisfatti.

  • I registri mostrano che i componenti OSGi personalizzati non creano istanze, con errori quali:

    • javax.jcr.nodetype.NoThatNodeTypeException: il client del tipo di nodo non esiste
    • Impossibile trovare il costruttore con 0 argomenti per i componenti dell’inizializzatore dell’autenticazione o del repository personalizzati

Causa

Non è possibile creare istanze di componenti OSGi personalizzati a causa di descrittori di componenti non corrispondenti, tipi di nodo JCR mancanti o configurazioni di fabbrica errate. Questo porta a errori del servizio di base e impedisce la corretta distribuzione.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Esamina il codice per i componenti OSGi personalizzati, ad esempio gli inizializzatori dell’archivio e i bundle di autenticazione.

  2. Verifica che tutti i tipi di nodo JCR a cui si fa riferimento (ad esempio: client) siano presenti prima dell’esecuzione di qualsiasi logica di creazione di cartelle nel codice personalizzato.

  3. Controlla i descrittori dei componenti OSGi per verificare che corrispondano alle firme del costruttore nelle classi compilate.

  4. Verificare che le configurazioni di fabbrica per i componenti di autenticazione personalizzati (come ProviderConfigImpl, ProviderConfigServiceManagerImpl, OAuthManagerImpl) siano corrette e che non siano state introdotte o modificate nell’ultima distribuzione.

  5. Convalida la configurazione del controllo di integrità:

    • Individua la configurazione OSGi per il controllo dello stato di Componenti richiesti (personalizzati) (in genere una configurazione di fabbrica per org.apache.felix.hc.generalchecks.ComponentsCheck, con tag personalizzati).

    • Conferma che l’elenco dei componenti richiesti includa i componenti personalizzati interessati.

    • Utilizza l’interfaccia utente touch di AEM (Strumenti > Operazioni > Verifica stato) per esaminare lo stato e i messaggi correnti per la verifica stato personalizzata.

  6. Dopo aver corretto i problemi identificati, ridistribuisci i bundle interessati e verifica che l’ambiente raggiunga uno stato pronto stabile e che tutti i controlli di integrità passino.

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