Risoluzione dei problemi

Se si dovessero riscontrare dei problemi con il proprio sito statico, consultare quanto segue per trovare suggerimenti e soluzioni agli errori più comuni.

Errore 403

Se la distribuzione del sito viene completata senza errori, ma viene visualizzato un errore 403 quando si tenta di visitare il sito nel browser, ecco alcune cose da controllare:

1. Se il sito dipende da una fase di build, il Comando di build (Impostazioni > Dettagli di base) è compilato e corretto?
2. La Directory di pubblicazione è corretta?
3. I permessi dei file* sono corretti? In genere si consigliano i seguenti permessi per i siti statici:
   • Directory: 755
   • File: 644

I *permessi dei file controllano chi può:

• Leggere: Visualizzare il contenuto di un file o visualizzare i file di una directory.
• Scrivere: Modificare un file, aggiungere o eliminare file in una directory.
• Eseguire: Eseguire un file e/o eseguirlo come script, oppure accedere a una directory ed eseguire funzioni e comandi.

Ogni file e directory ha una propria serie di permessi, indicati da un numero di 3 cifre. Ogni numero indica il livello di autorizzazione per ciascuna categoria (lettura, scrittura ed esecuzione) indicato sopra.

Errore 404

Se la distribuzione del sito viene completata senza errori ma viene visualizzato un errore 404 quando si cerca di visitare il sito nel browser, ci sono alcune cose da controllare:

1. Se il sito dipende da una fase di build, il comando Build (Impostazioni > Dettagli di base) è stato inserito correttamente?
2. La directory di pubblicazione è corretta?
3. Il repository è compatibile con l’Hosting di Siti Statici? Dovrebbe contenere o:
   1. Un framework per siti statici che utilizzi Node.js per la fase di build.
   2. Oppure file statici come HTML, CSS e Javascript che non richiedono una fase di build (lasciare il comando Build vuoto).

Il comando Build indica al nostro sistema come assemblare il sito e la directory di pubblicazione è la sottodirectory in cui si trovano i file del sito finito, rispetto alla root del repository. È fondamentale compilare correttamente questi campi se il sito dipende da una fase di build. In questo modo, ci si assicurerà che il sito venga costruito e servito come si desidera. Se il comando Build viene lasciato vuoto, il sistema potrebbe indicare che la distribuzione è completa, ma caricherà solo i contenuti non compilati del repository.

Versione Node non corretta

Se si aggiunge un comando di build per i propri siti, è possibile selezionare la versione di Node da utilizzare. Se si seleziona una versione errata, la distribuzione non sarà eseguita con successo, e apparirà un errore nel registro di build e rollout che indica la necessità di una versione di Node.js diversa, simile a questo:

"Build project": error [email protected]: The engine "node" is incompatible with this module. Expected version "16.14.0". Got "16.20.0"

Controllare le impostazioni del sito statico, modificare la versione node come necessario e distribuire di nuovo manualmente il sito. (Fare click su Distribuisci ora nella Pagina delle distribuzioni).

Impossibile determinare il Package Manager

Se si verifica un errore con il comando di build o il file di configurazione, si potrebbe visualizzare il seguente errore:

Error: Unable to determine package manager

Questo errore si verifica solitamente a causa di un comando di compilazione errato o di un file package.json mancante o non correttamente configurato. Ecco un paio di cose da controllare:

1. 1. Il Comando di build (Impostazioni > Dettagli di base) è compilato e corretto?
   2. Il file package.json è nel repository git?
   3. Il file package.json è configurato correttamente, compresa qualsiasi versione di Node in conflitto? Per esempio, potreste aver scelto la versione 18.16.0 di Node quando avete aggiunto il sito statico, ma nel file package.json, potreste aver impostato la versione di Node su qualcosa di diverso, come nel seguente esempio:
      Copy

      "engines": {
      "node": ">=20.0.0"
      },