Hvis du løber ind i problemer med din statiske hjemmeside, kan du finde tips og løsninger på almindelige fejl i det følgende.

403 fejl

Hvis implementeringen af dit websted fuldføres uden fejl, men du ser en 403-fejl, når du forsøger at besøge webstedet i din browser, er der et par ting, du skal kontrollere:‌

  1. Hvis dit websted afhænger af et byggetrin, er Build-kommandoen (Indstillinger > Grundlæggende detaljer) udfyldt og korrekt?
  2. Er Publish-biblioteket korrekt?
  3. Er dine filtilladelser* korrekte? Vi anbefaler generelt følgende tilladelser til statiske websteder:
    • Vejviser: 755
    • Filer: 644

*Filtilladelser kontrollerer, hvem der kan:

  • Læs: Se indholdet af en fil eller se filer i en mappe.
  • Skriv: Rediger en fil, eller tilføj eller slet filer i en mappe.
  • Udfør: Kør en fil og/eller kør den som et script, eller få adgang til en mappe og udfør funktioner og kommandoer.

Hver fil og mappe har sit eget sæt filtilladelser, vist som et 3-cifret nummer. Hvert tal angiver tilladelsesniveauet for hver kategori (læs, skriv og udfør) vist ovenfor.

404-fejl

Hvis implementeringen af dit websted fuldføres uden fejl, men du ser en 404-fejl, når du forsøger at besøge webstedet i din browser, er der et par ting, du skal kontrollere:

  1. Hvis dit site afhænger af et build-trin, er kommandoen Build (Indstillinger > Grundlæggende detaljer) så udfyldt og korrekt?
  2. Er udgivelsesmappen korrekt?
  3. Er dit repository kompatibelt med Static Site Hosting? Det skal indeholde enten:
    1. Et statisk website-framework, der bruger Node.js til build-trinnet.
    2. Eller statiske filer som HTML, CSS og Javascript, der ikke kræver et build-trin (lad kommandoen Build være tom).

Kommandoen Build fortæller vores system, hvordan det skal samle din hjemmeside, og mappen Udgiv er den undermappe, hvor de færdige hjemmesidefiler ligger, i forhold til roden af dit repository. Det er vigtigt at udfylde disse felter korrekt, hvis dit site afhænger af et build-trin. Det vil sikre, at dit site bliver bygget og serveret, som du har tænkt dig. Hvis kommandoen Build ikke er udfyldt, kan systemet angive, at implementeringen er fuldført, men det vil kun uploade det ubyggede indhold i dit repository.

Forkert nodeversion

Hvis du indtaster en build-kommando til dit websted, kan du vælge den nodeversion, du vil bruge. Hvis du vælger den forkerte version, vil implementeringen mislykkes, og der vil være en fejl i Build- og udrulningsloggen, der indikerer, at en anden Node.js-version er nødvendig, svarende til denne:

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

Tjek dit statiske websteds indstillinger, skift nodeversionen efter behov, og implementer webstedet manuelt igen (klik på Implementer nu på siden Implementeringer).

Kan ikke bestemme pakkeadministrator

Hvis der opstår et problem med build-kommandoen eller konfigurationsfilen, kan du muligvis se følgende fejl:

Fejl: Kan ikke bestemme pakkehåndtering

Denne fejl opstår normalt på grund af en forkert build-kommando eller en manglende eller forkert konfigureret package.json-fil. Her er et par ting at tjekke:‌

  1. Er kommandoen Build (Indstillinger > Grundlæggende detaljer) udfyldt og korrekt?
  2. Er filen package.json i dit git-lager?
  3. Er filen package.json konfigureret korrekt, inklusive enhver modstridende nodeversion? For eksempel kan du have valgt Node version 18.16.0, da du tilføjede det statiske websted, men i filen package.json kan du have indstillet Node-versionen til noget andet, som det følgende eksempel: 
    "engines": {
"node": ">=20.0.0"
},

Relateret dokumentation