DocumentazioneAEMTutorial su AEM as a Cloud Service

Risolvere i problemi relativi all’estensibilità di Asset Compute

Ultimo aggiornamento: 24 luglio 2026
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Intermediate
  • Experienced
  • Developer

Di seguito è riportato un indice dei problemi e degli errori comuni, insieme alle risoluzioni, che possono essere riscontrati durante lo sviluppo e la distribuzione di processi di lavoro Asset Compute personalizzati per AEM Assets.

Sviluppare develop

La rappresentazione è parzialmente disegnata/danneggiata rendition-returned-partially-drawn-or-corrupt

  • Errore: il rendering della rappresentazione non viene eseguito completamente (quando un’immagine) o è danneggiato e non può essere aperto.

    Rendering restituito parzialmente disegnato

  • Causa: la funzione renditionCallback del processo di lavoro verrà chiusa prima che il rendering possa essere scritto completamente in rendition.path.

  • Risoluzione: rivedere il codice del processo di lavoro personalizzato e assicurarsi che tutte le chiamate asincrone siano sincronizzate utilizzando await.

Strumento di sviluppo development-tool

File Console.json mancante nel progetto Asset Compute missing-console-json

  • __Errore file richiesti mancanti alla convalida (.../node_modules/@adobe/asset-compute-client/lib/integrationConfiguration.js:XX:YY) in setupAssetCompute asincrono (.../node_modules/@adobe/asset-compute-devtool/src/assetComputeDevTool.js:XX:YY)

  • __Causa :__File console.json mancante nella radice del progetto Asset Compute

  • __Risoluzione :__Scarica un nuovo console.json dal tuo progetto Adobe I/O

    1. In console.adobe.io, apri il progetto Adobe I/O per il quale il progetto Asset Compute è configurato
    2. Tocca il pulsante Scarica in alto a destra
    3. Salva il file scaricato nella directory principale del progetto Asset Compute utilizzando il nome file console.json

Rientro YAML non corretto in manifest.yml incorrect-yaml-indentation

  • __Errore rientro non valido di una voce di mappatura alla riga X, colonna Y:(tramite l’uscita standard dal comando aio app run)
  • __Causa :__I file Yaml sono sensibili a spazi vuoti, è probabile che il rientro non sia corretto.
  • __Risoluzione :__Rivedi manifest.yml e assicurati che tutti i rientri siano corretti.

Il limite memorySize è impostato su un valore troppo basso memorysize-limit-is-set-too-low

  • __Errore :__OpenWhiskError del server di sviluppo locale: PUT https://adobeioruntime.net/api/v1/namespaces/xxx-xxx-xxx/actions/xxx-0.0.1/__secured_workeroverwrite=true ha restituito HTTP 400 (richiesta non valida) —> “Il formato del contenuto della richiesta non è valido:requirement non è riuscito: 64 MB di memoria al di sotto della soglia consentita di 134217728 B”
  • __Causa :__Un limite memorySize per il processo di lavoro in manifest.yml è stato impostato al di sotto della soglia minima consentita, come riportato dal messaggio di errore in byte.
  • __Risoluzione :__Rivedere i limiti memorySize in manifest.yml e assicurarsi che siano tutti grandi rispetto alla soglia minima consentita.

Impossibile avviare lo strumento di sviluppo. Private.key mancante missing-private-key

  • __Errore :__Server di sviluppo localeErrore: file richiesti mancanti in validatePrivateKeyFile… (tramite l’uscita standard dal comando aio app run)
  • __Causa :__Il valore ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH nel file .env non punta a private.key o private.key non è leggibile dall’utente corrente.
  • __Risoluzione :__Rivedere il valore ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH nel file .env e assicurarsi che contenga il percorso completo e assoluto di private.key nel file system.

Lo strumento di sviluppo Asset Compute potrebbe entrare in uno stato in cui vengono estratti dati non aggiornati ed è più evidente nel menu a discesa Source file che mostra elementi non corretti.

  • __Errore :__nel menu a discesa del file Source vengono visualizzati elementi non corretti.
  • __Causa :__Lo stato obsoleto del browser nella cache causa la
  • __Risoluzione :__Nel browser cancellare completamente lo “stato applicazione” della scheda del browser, la cache del browser, l’archiviazione locale e il processo di lavoro del servizio.

Parametro query devToolToken mancante o non valido missing-or-invalid-devtooltoken-query-parameter

  • __Errore :__notifica “Non autorizzato” nello strumento di sviluppo Asset Compute
  • Causa :devToolToken mancante o non valida
  • __Risoluzione :__Chiudere la finestra del browser Strumento di sviluppo Asset Compute, terminare tutti i processi dello strumento di sviluppo in esecuzione avviati tramite il comando aio app run e riavviare lo strumento di sviluppo (utilizzando aio app run).

Impossibile rimuovere i file di origine unable-to-remove-source-files

  • __Errore :__Impossibile rimuovere i file di origine aggiunti dall’interfaccia utente degli strumenti di sviluppo

  • __Causa :__Funzionalità non implementata

  • __Risoluzione :Accedi al provider di archiviazione cloud utilizzando le credenziali definite in .env. Individuare il contenitore utilizzato dagli strumenti di sviluppo (specificato anche in .env), passare alla cartella source __ed eliminare le immagini di origine. Potrebbe essere necessario eseguire i passaggi descritti nel menu a discesa File Source non corretti se i file di origine eliminati continuano a essere visualizzati nel menu a discesa in quanto potrebbero essere memorizzati nella cache locale nello “stato applicazione” degli strumenti di sviluppo.

    Archiviazione BLOB di Microsoft Azure

Test test

Nessuna rappresentazione generata durante l’esecuzione del test test-no-rendition-generated

  • Errore :: nessuna rappresentazione generata.

  • __Causa :__Il processo di lavoro non è riuscito a generare una rappresentazione a causa di un errore imprevisto, ad esempio un errore di sintassi JavaScript.

  • __Risoluzione :__Rivedi test.log dell’esecuzione del test alle /build/test-results/test-worker/test.log. Individua la sezione in questo file corrispondente al test case non riuscito e individua eventuali errori.

    Risoluzione dei problemi - Nessuna rappresentazione generata

Il test genera una rappresentazione errata causando un errore del test tests-generates-incorrect-rendition

  • Errore :: rendering ‘rendition.xxx’ non conforme al previsto.

  • __Causa :__Il processo di lavoro ha restituito una rappresentazione diversa da quella fornita da rendition.<extension> nel test case.

    • Se il file rendition.<extension> previsto non viene creato esattamente nello stesso modo della rappresentazione generata localmente nel test case, il test potrebbe non riuscire in quanto ci potrebbe essere una qualche differenza nei bit. Ad esempio, se il processo di lavoro di Asset Compute modifica il contrasto utilizzando le API e il risultato atteso viene creato regolando il contrasto in Adobe Photoshop CC, i file possono apparire gli stessi, ma le variazioni minori nei bit possono essere diverse.

  • __Risoluzione :__Rivedere l’output del rendering dal test passando a /build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension> e confrontarlo con il file di rendering previsto nel test case. Per creare una risorsa prevista esatta:

    • Utilizza lo strumento di sviluppo per generare una rappresentazione, convalidarla correttamente e utilizzarla come file di rappresentazione previsto
    • In alternativa, convalidare il file generato da test in /build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension>, verificarne la correttezza e utilizzarlo come file di rendering previsto

Debug

Il debugger non si collega debugger-does-not-attach

  • Errore: errore durante l’elaborazione del lancio. Errore: impossibile connettersi alla destinazione di debug in…
  • Causa: Docker Desktop non è in esecuzione nel sistema locale. Verifica questo fatto esaminando la console di debug del codice VS (Visualizza > Console di debug), e conferma che questo errore sia segnalato.
  • Risoluzione: avviare Docker Desktop e verificare che le immagini Docker richieste siano installate.

Punti di interruzione non in pausa breakpoints-no-pausing

  • Errore: quando si esegue il processo di lavoro Asset Compute dallo strumento di sviluppo con debug, il codice VS non viene messo in pausa nei punti di interruzione.

Debugger codice VS non collegato vs-code-debugger-not-attached

  • __Causa :__Il debugger del codice di Visual Studio è stato arrestato/disconnesso.
  • __Risoluzione :__Riavviare il debugger del codice VS e verificarne il collegamento guardando la console Output debug del codice VS (Visualizza > Console debug)

Debugger del codice VS collegato dopo l’avvio dell’esecuzione del processo di lavoro vs-code-debugger-attached-after-worker-execution-began

  • Causa: Il debugger del codice di Visual Studio non è stato collegato prima di toccare Esegui nello strumento di sviluppo.
  • __Risoluzione :__Verificare che il debugger sia collegato esaminando la console di debug di VS Code (Visualizza > Console di debug), quindi eseguire nuovamente Asset Compute worker da Development Tool.

Timeout del processo di lavoro durante il debug worker-times-out-while-debugging

  • Errore: nella console di debug viene segnalato che “l’azione verrà interrotta tra -XXX millisecondi” oppure che l’anteprima della copia trasformata 🔗 di Asset Compute Development Tool si estende per un tempo indefinito oppure
  • Causa: il timeout del processo di lavoro definito in manifest.yml è stato superato durante il debug.
  • Risoluzione: aumenta temporaneamente il timeout del lavoratore in manifest.yml o accelera le attività di debug.

Impossibile terminare il processo del debugger cannot-terminate-debugger-process

  • Errore: Ctrl-C nella riga di comando non termina il processo del debugger (npx adobe-asset-compute devtool).

  • Causa: un bug in @adobe/aio-cli-plugin-asset-compute 1.3.x causa il mancato riconoscimento di Ctrl-C come comando di terminazione.

  • Risoluzione: aggiornamento di @adobe/aio-cli-plugin-asset-compute alla versione 1.4.1+

    code language-none 
    $ aio update

    Risoluzione dei problemi - Aggiornamento aio

Distribuzione deploy

Rappresentazione personalizzata mancante nella risorsa in AEM custom-rendition-missing-from-asset

  • __Errore :__Le risorse nuove ed elaborate nuovamente sono state elaborate correttamente, ma manca la rappresentazione personalizzata

Profilo di elaborazione non applicato alla cartella predecessore

  • __Causa :__La risorsa non esiste in una cartella con il profilo di elaborazione che utilizza il processo di lavoro personalizzato
  • __Risoluzione :__Applica il profilo di elaborazione a una cartella predecessore della risorsa

Profilo di elaborazione sostituito da Profilo di elaborazione inferiore

  • __Causa :__La risorsa esiste in una cartella a cui è applicato il profilo di elaborazione del processo di lavoro personalizzato. Tra la cartella e la risorsa è stato tuttavia applicato un profilo di elaborazione diverso che non utilizza il processo di lavoro del cliente.
  • __Risoluzione :__Combinare o riconciliare in altro modo i due profili di elaborazione e rimuovere il profilo di elaborazione intermedio

L’elaborazione delle risorse in AEM non riesce asset-processing-fails

  • __Errore :__durante l’elaborazione della risorsa. Badge non riuscito visualizzato nella risorsa
  • __Causa :__Errore durante l’esecuzione del processo di lavoro personalizzato
  • __Risoluzione :__Segui le istruzioni su debug delle attivazioni di Adobe I/O Runtime tramite aio app logs.
recommendation-more-help
experience-manager-learn-help-cloud-service