Correggere gli errori di deserializzazione dopo l’aggiornamento di AEM Forms

Ultimo aggiornamento: 31 ottobre 2026

Dopo l’aggiornamento di Adobe Experience Manager (AEM) Forms alla versione 6.5.25 sul server applicazioni IBM WebSphere 9.0.5.28, durante l’avvio del server e l’esecuzione di Configuration Manager vengono visualizzati errori di deserializzazione. Per risolvere questo problema, configura l’agente Java notsoserial con un argomento JVM obbligatorio che inizializza il relativo inserisco nell’elenco Consentiti di all’avvio perché il cliente non dispone di CRX.

Descrizione description

Ambiente

Prodotto: Adobe Experience Manager (AEM) Forms JEE
Versione: 6.5.25, aggiornato dal 6.5.23
Server applicazioni: server applicazioni IBM WebSphere 9.0.5.28
Sistema operativo: Windows Server 2022 Datacenter

Problema/Sintomi

Dopo l’aggiornamento ad AEM Forms 6.5.25 e l’avvio dell’applicazione su IBM WebSphere, nei registri viene visualizzato un numero elevato di messaggi di errore deserializzazione non consentita per la classe.
Gli errori vengono visualizzati durante l’avvio del server e l’esecuzione di Configuration Manager.

Risoluzione resolution

Per risolvere il problema, eseguire la procedura seguente:

Verificare che il file notsoserial.jar sia presente nella directory utilizzata dall’applicazione AEM distribuita su WebSphere, ad esempio la directory installedApps per l’istanza del server applicazioni.
Creare un file vuoto denominato is-deserialized.txt nella stessa directory di notsoserial.jar.
In WebSphere Admin Console, vai a Servers >[ your server] > Java and Process Management > Process Definition > Java Virtual Machine > Generic JVM arguments.

Aggiungi o aggiorna il seguente argomento JVM:

code language-none
`-javaagent:<path-to-notsoserial.jar> -Dnotsoserial.dryrun=<path-to-is-deserialized.txt>`

Sostituisci <path-to-notsoserial.jar> e <path-to-is-deserialized.txt> con i loro percorsi completi.

Rimuovi eventuali argomenti JVM correlati precedenti, a meno che l’ambiente non li richieda specificatamente:

code language-none
`-Dorg.kantega.notsoserial.allow=... -Djdk.serialFilter=...`

Salvare le modifiche e riavviare il server applicazioni WebSphere.
Dopo il riavvio, verificare che gli errori di deserializzazione non vengano più visualizzati in SystemOut.log o in altri registri rilevanti durante l’avvio e l’esecuzione di Configuration Manager.

Note

La proprietà -Dnotsoserial.dryrun forza l’inizializzazione del elenco Consentiti di all’avvio, necessaria per il corretto funzionamento durante l’avvio di JNDI.
Mantieni questi argomenti JVM per patch o aggiornamenti futuri. Se gli errori di deserializzazione riappaiono dopo la manutenzione, verificare che queste impostazioni siano ancora presenti.
Il percorso di notsoserial.jar varia a seconda della struttura di distribuzione. Assicurati di fare riferimento al percorso corretto per l’ambiente.
Non vengono forniti ulteriori passaggi per la risoluzione dei problemi oltre a quelli descritti in precedenza.

recommendation-more-help

experience-cloud-kcs-help-kbarticles