View a markdown version of this page

AWS SAM CLI risoluzione dei problemi - AWS Serverless Application Model

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS SAM CLI risoluzione dei problemi

Questa sezione fornisce dettagli su come risolvere i messaggi di errore durante l'utilizzo, l'installazione e la gestione di AWS Serverless Application Model Interfaccia a riga di comando (AWS SAM CLI).

Risoluzione dei problemi

Per indicazioni sulla risoluzione dei problemi relativi a AWS SAM CLI, vedi Risoluzione degli errori di installazione.

Messaggi di errore

Errore curl: «curl: (6) Impossibile risolvere:...»

Quando si tenta di richiamare l'endpoint API Gateway, viene visualizzato il seguente errore:

curl: (6) Could not resolve: endpointdomain (Domain name not found)

Ciò significa che hai tentato di inviare una richiesta a un dominio non valido. Questo può accadere se la tua applicazione serverless non è stata distribuita correttamente o se hai un errore di battitura curl comando. Verificare che l'applicazione sia stata distribuita correttamente utilizzando CloudFormation console o AWS CLI e verifica che il tuo curl il comando è corretto.

Errore: impossibile trovare le informazioni esatte sulle risorse con il nome dello stack specificato

Quando si esegue il sam remote invoke su un'applicazione che contiene una singola risorsa Lambda Event Function, viene visualizzato il seguente errore:

Error: Can't find exact resource information with given <stack-name>. Please provide full resource ARN or --stack-name to resolve the ambiguity.
Possibile causa: non hai fornito il --stack-name opzione.

Se una funzione ARN non viene fornita come argomento, sam remote invoke il comando richiede che --stack-name viene fornita l'opzione.

Soluzione: fornire --stack-name opzione.

Di seguito è riportato un esempio:

$ sam remote invoke --stack-name sam-app Invoking Lambda Function HelloWorldFunction START RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82 Version: $LATEST END RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82 REPORT RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82 Duration: 11.31 ms Billed Duration: 12 ms Memory Size: 128 MB Max Memory Used: 67 MB Init Duration: 171.71 ms {"statusCode":200,"body":"{\"message\":\"hello world\"}"}%

Errore: impossibile trovare le informazioni sulle risorse dal nome dello stack

Quando si esegue il sam remote invoke e passando una funzione Lambda ARN come argomento, viene visualizzato il seguente errore:

Error: Can't find resource information from stack name (<stack-name>) and resource id (<function-id>)
Causa possibile: hai il valore del nome dello stack definito nel tuo samconfig.toml file.

Il AWS SAM CLI controlla prima il tuo samconfig.toml file con il nome di uno stack. Se specificato, l'argomento viene passato come valore ID logico.

Soluzione: passate invece l'ID logico della funzione.

È possibile passare l'ID logico della funzione come argomento anziché l'ARN della funzione.

Soluzione: rimuovi il valore del nome dello stack dal file di configurazione.

Puoi rimuovere il valore del nome dello stack dal tuo file di configurazione. Ciò impedisce AWS SAM CLI dal passare la funzione ARN come valore ID logico.

Esegui sam build dopo aver modificato il file di configurazione.

Errore: creazione delle risorse gestite non riuscita: impossibile individuare le credenziali

Quando si esegue il sam deploy comando, viene visualizzato il seguente errore:

Error: Failed to create managed resources: Unable to locate credentials

Ciò significa che non hai configurato AWS credenziali per abilitare il AWS SAM CLI da fare AWS chiamate di servizio. Per risolvere questo problema, è necessario configurare AWS credenziali. Per ulteriori informazioni, consulta Impostazione delle AWS credenziali.

Errore: FileNotFoundError in Windows

Quando si eseguono comandi in AWS SAM CLI su Windows, potresti visualizzare il seguente errore:

Error: FileNotFoundError

Possibile causa: AWS SAM CLI potrebbe interagire con percorsi di file che superano il limite massimo di percorso di Windows.

Soluzione: per risolvere questo problema, è necessario abilitare il nuovo comportamento dei percorsi lunghi. A tale scopo, consulta Abilita i percorsi lunghi in Windows 10, versione 1607 e successive nel Documentazione sullo sviluppo di app per Microsoft Windows.

Errore: risolutore di dipendenze di pip...

Esempio di testo dell’errore:

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. 
aws-sam-cli 1.58.0 requires aws-sam-translator==1.51.0, but you have aws-sam-translator 1.58.0 which is incompatible. 
aws-sam-cli 1.58.0 requires typing-extensions==3.10.0.0, but you have typing-extensions 4.4.0 which is incompatible.
Possibile causa: se si utilizza pip per installare i pacchetti, le dipendenze tra i pacchetti possono entrare in conflitto.

Ogni versione di aws-sam-cli il pacchetto dipende da una versione di aws-sam-translator pacchetto. Ad esempio, aws-sam-cli v1.58.0 può dipendere da aws-sam-translator v1.51.0.

Se installi AWS SAM CLI utilizzando pip, quindi installa un altro pacchetto che dipende da una versione più recente di aws-sam-translator, si verificherà quanto segue:

  • La versione più recente di aws-sam-translator installerà.

  • La versione attuale di aws-sam-cli e la versione più recente di aws-sam-translator potrebbe non essere compatibile.

  • Quando si utilizza AWS SAM CLI, si verificherà l'errore del risolutore delle dipendenze.

Soluzioni:
  1. Usa il AWS SAM CLI programma di installazione di pacchetti nativo.

    1. Disinstallare il AWS SAM CLI usando pip. Per istruzioni, consulta l’argomento Disinstallazione di AWS SAMCLI.

    2. Installa il AWS SAM CLI utilizzando il programma di installazione del pacchetto nativo. Per istruzioni, consulta l’argomento Installa il AWS SAM CLI.

    3. Se necessario, aggiorna il AWS SAM CLI utilizzando il programma di installazione del pacchetto nativo. Per istruzioni, consulta l’argomento Aggiornamento del AWS SAMCLI.

  2. Se è necessario utilizzare pip, ti consigliamo di installare AWS SAM CLI in un ambiente virtuale. Ciò garantisce un ambiente di installazione pulito e un ambiente isolato in caso di errori. Per istruzioni, consulta l’argomento Installare il file AWS SAMCLI in un ambiente virtuale utilizzando pip.

Errore: nessun comando di questo tipo «remoto»

Quando si esegue il sam remote invoke comando, viene visualizzato il seguente errore:

$ sam remote invoke ... 2023-06-20 08:15:07 Command remote not available Usage: sam [OPTIONS] COMMAND [ARGS]... Try 'sam -h' for help. Error: No such command 'remote'.
Causa possibile: la tua versione di AWS SAM CLI è scaduto.

Il AWS SAM CLI sam remote invoke il comando è stato rilasciato con AWS SAM CLI versione 1.88.0. Puoi verificare la tua versione eseguendo sam --version comando.

Soluzione: aggiorna il tuo AWS SAM CLI alla versione più recente.

Per istruzioni, consulta l’argomento Aggiornamento del AWS SAMCLI.

Errore: in esecuzione AWS I progetti SAM richiedono localmente Docker. L'hai installato?

Quando si esegue il sam local start-api comando, viene visualizzato il seguente errore:

Error: Running AWS SAM projects locally requires Docker. Have you got it installed?

Ciò significa che non hai Docker installato correttamente. Docker è necessario per testare l'applicazione in locale. Per risolvere questo problema, segui le istruzioni per installare Docker per il tuo host di sviluppo. Per ulteriori informazioni, consulta Installazione di Docker.

Errore: vincoli di sicurezza non soddisfatti

Durante l'esecuzione sam deploy --guided, ti viene posta la domanda Function may not have authorization defined, Is this okay? [y/N]. Se rispondi a questa richiesta con N (risposta predefinita), viene visualizzato il seguente errore:

Error: Security Constraints Not Satisfied

Il prompt ti informa che l'applicazione che stai per distribuire potrebbe avere un'API Amazon API Gateway accessibile al pubblico configurata senza autorizzazione. Rispondendo N a questo prompt, stai dicendo che non va bene.

Per risolvere questo problema, hai le seguenti opzioni:

  • Configura la tua applicazione con l'autorizzazione. Per informazioni sulla configurazione dell'autorizzazione, vedere Controlla l'accesso alle API con il tuo AWS SAM modello.

  • Se intendi avere un endpoint API accessibile al pubblico senza autorizzazione, riavvia la distribuzione e rispondi a questa domanda con Y per indicare che sei d'accordo con la distribuzione.

messaggio: Token di autenticazione mancante

Quando si tenta di richiamare l'endpoint API Gateway, viene visualizzato il seguente errore:

{"message":"Missing Authentication Token"}

Ciò significa che hai tentato di inviare una richiesta al dominio corretto, ma l'URI non è riconoscibile. Per risolvere questo problema, verifica l'URL completo e aggiorna il curl comando con l'URL corretto.

Errore: impossibile usare --resolve-s3 con un AWS::Serverless::WebFunction che ha un codice locale

Quando si esegue il sam package --resolve-s3 comando, se viene visualizzato questo errore, significa che il codice Web Function non può essere archiviato nel bucket gestito e sam package non ha uno stack per cui creare un bucket di codice. Per risolvere questo problema, esegui sam deploy, che crea un bucket di codice per lo stack, o pass --s3-bucket con un bucket che soddisfa i requisiti della funzione Web. Per ulteriori informazioni, consulta Creazione e distribuzione di Lambda Web Functions.

Errore: Lambda Web Functions non è in grado di leggere il codice caricato con queste impostazioni

Durante l'esecuzione sam package, sam deploy, o sam sync con --s3-bucket, se vedi questo errore seguito da uno o più problemi, significa che Lambda rifiuterebbe una revisione di Web Function che legge il codice da questo bucket. Il bucket non ha il controllo delle versioni abilitato, oppure --kms-key-id è un AWS chiave gestita. Per risolvere questo problema, abilita il controllo delle versioni sul bucket o imposta --kms-key-id a una chiave gestita dal cliente la cui politica chiave lo consente lambda.amazonaws.com chiamare kms:Decrypt. Per ulteriori informazioni, consulta Creazione e distribuzione di Lambda Web Functions.

Messaggi di avviso

Avvertenza:... AWS non manterrà più il Homebrew installatore per AWS SAM ...

Durante l'installazione di AWS SAM CLI utilizzando Homebrew, viene visualizzato il seguente messaggio di avviso:

Warning: ... AWS will no longer maintain the Homebrew installer for AWS SAM (aws/tap/aws-sam-cli). 
				For AWS supported installations, use the first party installers ...
Causa potenziale: AWS non mantiene più Homebrew supporto.

A partire da settembre 2023, AWS non manterrà più il Homebrew installatore per AWS SAM CLI.

Soluzione: utilizzare un AWS metodo di installazione supportato.
Soluzione: continuare a usare Homebrew, usa il programma di installazione gestito dalla community.