# HTTP-foutcodes op KapsuleHost

Source: https://support.kapsulehost.com/nl-nl/http-error-codes

Wat 403, 404, 500, 502, 503 en 504 precies betekenen op dit platform, en de specifieke actie die bij elk hoort.

Een foutcode is geen algemeen foutbericht. Het vertelt je welke laag van de stack het heeft opgegeven, en dat beperkt de oorzaak aanzienlijk. Een 502 en een 504 zien er voor een bezoeker identiek uit, maar hebben compleet verschillende oorzaken en oplossingen.

## De werkelijke code lezen

Voordat je gaat oplossen, achterhaal het echte nummer. Een mooie foutpagina kan iets anders zeggen dan wat de server daadwerkelijk teruggeeft.

Open in je browser de ontwikkelaarstools, ga naar het tabblad Netwerk, herlaad de pagina en klik op het eerste verzoek. De status staat bovenaan het paneel Headers.

Vanuit een terminal:

```sh
curl -sSI https://yourdomain.com/
```

Dit toont de statusregel en de response headers zonder de pagina te downloaden. De headers zijn belangrijk: verschillende van de onderstaande gevallen worden herkend aan een header in plaats van aan de code alleen.

![De responsstatus lezen in de ontwikkelaarstools van de browser](https://support.kapsulehost.com/help/screenshots/http-error-codes.fdd177cf.webp)

## De korte versie

| Code | Betekenis | Wiens probleem |
|---|---|---|
| 401 | Authenticatie vereist | Wachtwoordbeveiliging staat aan |
| 403 | Opzettelijk geweigerd | Een beveiligingsregel heeft het verzoek geblokkeerd |
| 404 | Niet gevonden | Jouw site, meestal routering |
| 500 | Jouw applicatie is gecrasht | Jouw code of een plugin |
| 502 | De server achter de webserver is uitgevallen | Meestal jouw applicatie |
| 503 | Bewust nu niet beschikbaar | Opgeschort, gepauzeerd of onderhoud |
| 504 | Duurde te lang | Iets in jouw code is traag |

## 401 Unauthorized

Je ziet een browservenster voor gebruikersnaam en wachtwoord in plaats van een pagina. Dat betekent dat er basale wachtwoordbeveiliging is ingeschakeld op de site of op dat pad.

Schakel dit uit, of haal de inloggegevens op, via **Websites**, de site, **Instellingen**, dan **Wachtwoordbeveiliging**. Zie [Wachtwoordbeveiliging](https://support.kapsulehost.com/nl-nl/site-password-protect).

Certificaatvernieuwing blijft werken terwijl wachtwoordbeveiliging aanstaat, dus dit zal je HTTPS niet verstoren.

## 403 Forbidden

403 betekent dat iets het verzoek bewust heeft geweigerd. Op dit platform zijn er vier afzonderlijke bronnen.

**De web application firewall.** Elke site staat achter een regelsysteem dat binnenkomende verzoeken inspecteert en verzoeken blokkeert die overeenkomen met bekende aanvalspatronen. Dit is de meest voorkomende bron van een onverwachte 403, en het is vrijwel altijd een vals-positief resultaat bij een legitiem maar ongebruikelijk verzoek: een lange formulierinzending, een paginabouwer die complexe content opslaat, een plugin die ruwe code verzendt.

Symptomen van een firewallblokkering: één specifieke actie mislukt steeds met 403 terwijl de rest van de site prima werkt, en dit gebeurt identiek in een andere browser en op een ander netwerk.

De oplossing is een gerichte uitzondering op de regel, die support kan toevoegen. Zoek niet naar een schakelaar om de firewall uit te zetten; die bestaat niet voor shared hosting, en dat zou sowieso de verkeerde oplossing zijn. Open een ticket met de exacte URL, het exacte tijdstip, en wat je aan het doen was. Zie [Een supportticket openen](https://support.kapsulehost.com/nl-nl/opening-a-support-ticket).

**Geoblokkering.** Als je jouw site hebt beperkt tot bepaalde landen, krijgt iedereen daarbuiten een 403. Controleer **Instellingen**, dan **Beveiliging**. Zie [Geoblokkering](https://support.kapsulehost.com/nl-nl/site-geo-blocking).

**Een IP-blokkering.** Ofwel een die je zelf hebt toegevoegd onder Beveiliging, ofwel een platformbrede misbruikblokkering.

**Een probleem met bestandsrechten of symlinks.** Minder gebruikelijk, en dit komt meestal naar voren na een handmatige bestandsbewerking via SSH.

## 404 Not Found

De server heeft geantwoord, maar er staat niets op dat adres.

**Eén pagina geeft 404.** Het bestand of bericht bestaat daadwerkelijk niet, of de URL is fout.

**Elke pagina behalve de homepage geeft 404.** Dit is een routeringsprobleem, en bij WordPress zijn het bijna altijd permalinks. Belangrijk: KapsuleHost webhosting draait op nginx, niet Apache, dus `.htaccess` rewrite-regels doen hier niets. Als je bent gemigreerd van een host die deze gebruikte, is dat jouw oorzaak. Zie [Problemen met permalinks](https://support.kapsulehost.com/nl-nl/wordpress-permalink-issues) en [WordPress en .htaccess](https://support.kapsulehost.com/nl-nl/wordpress-htaccess).

**De hele site geeft 404.** Controleer of de site naar de juiste documentroot wijst en of jouw domein aan de juiste site is gekoppeld. Zie [Aangepast domein voor een website](https://support.kapsulehost.com/nl-nl/custom-domain-for-website).

**Het werkt op jouw computer maar geeft 404 live.** Linux-bestandsnamen zijn hoofdlettergevoelig. `Logo.PNG` en `logo.png` zijn twee verschillende bestanden.

## 500 Internal Server Error

Jouw applicatie draaide en is gecrasht. De webserver is in orde; de code niet.

Dit is het ene geval waarbij de logs je bijna onmiddellijk het antwoord geven, omdat een fatale PHP-fout het bestand en het regelnummer registreert waar het misging, wat meestal precies de plugin aanwijst.

1. Ga naar **Websites**, de site, **Instellingen**, dan **Logboeken**.
2. Bekijk de meest recente vermeldingen.
3. Koppel het tijdstempel aan het moment waarop je de fout zag.

Zie [Foutlogs](https://support.kapsulehost.com/nl-nl/error-logs). Voor de WordPress-specifieke variant hiervan, waarbij de pagina leeg is in plaats van een foutmelding te tonen, zie [Het witte scherm van WordPress](https://support.kapsulehost.com/nl-nl/wordpress-white-screen).

De meest voorkomende oorzaken zijn een plugin of thema dat niet compatibel is met jouw PHP-versie, een bereikte geheugenlimiet, en een mislukte databaseverbinding. Zie [PHP-extensies en -instellingen](https://support.kapsulehost.com/nl-nl/php-extensions-and-ini) en [WordPress-geheugenlimiet](https://support.kapsulehost.com/nl-nl/wordpress-memory-limit).

## 502 Bad Gateway

De webserver probeerde het verzoek door te geven aan jouw applicatie en kreeg niets bruikbaars terug. Het applicatieproces weigerde de verbinding of stierf halverwege het verzoek.

Veelvoorkomende oorzaken:

- Een PHP-proces crashte, vaak door geheugengebrek bij één verzoek.
- Een Node.js-applicatie draait niet, of is gecrasht bij het opstarten.
- Een piek in verkeer putte de beschikbare workerprocessen uit.

Wat te doen: controleer eerst de logs, zoals hierboven. Als het een Node-applicatie betreft, controleer of het proces daadwerkelijk actief is en bekijk de opstartuitvoer. Als 502's alleen op je drukste momenten verschijnen, is het een capaciteitsprobleem in plaats van een bug. Zie [Traagheid van de site en resourcelimieten](https://support.kapsulehost.com/nl-nl/site-slow-resource-limits).

> **Note:** Een 502 van KPanel zelf, bij het opslaan van een instelling, betekent iets anders. Het betekent dat het paneel de configuratiewijziging niet kon toepassen op de webserver, en de wijziging heeft teruggedraaid in plaats van je site half geconfigureerd achter te laten. Jouw website wordt hierdoor niet beïnvloed. Probeer het opnieuw, en als het steeds mislukt, open dan een ticket.

## 503 Service Unavailable

503 betekent dat de server de site op dit moment bewust niet aanbiedt. Er zijn drie specifieke oorzaken op dit platform, en de reactie vertelt je welke.

**Jouw site is opgeschort.** Je ziet een pagina met de kop "This site is paused". Dit is een factuur- of accountstatus, geen technisch defect, en de site komt direct terug zodra de status is opgeheven. Controleer **Facturering**. Zie [Mislukte betaling](https://support.kapsulehost.com/nl-nl/billing-failed-payment) en [Account opgeschort](https://support.kapsulehost.com/nl-nl/account-suspended).

**Platformonderhoud.** Een platformbrede onderhoudspagina, wat zeldzaam is en vooraf wordt aangekondigd. Controleer [Status en uptime](https://support.kapsulehost.com/nl-nl/status-and-uptime).

## 504 Gateway Timeout

Jouw applicatie werkte nog toen de webserver geen geduld meer had. Er is niets gecrasht. Het was gewoon te traag.

Typische oorzaken:

- Een langlopende import, export, back-up of bulkbewerking uitgevoerd via de browser.
- Een plugin die bij elke pagina-weergave een trage externe API aanroept.
- Een kostbare databasequery zonder index erachter.
- Een cron-taak die wordt geactiveerd door een paginaweergave in plaats van door een echte cron.

Wat te doen:

1. Bepaal welk verzoek traag is. Het tabblad APM op WordPress-sites toont dit. Zie [Sitesnelheid](https://support.kapsulehost.com/nl-nl/site-performance).
2. Gebruik voor langdurige bewerkingen de command line in plaats van de browser. Zie [WP-CLI](https://support.kapsulehost.com/nl-nl/wordpress-wp-cli).
3. Verplaats gepland werk naar echte cron. Zie [Cron-taken](https://support.kapsulehost.com/nl-nl/cron-jobs).
4. Verhoog `max_execution_time` als het werk daadwerkelijk meer tijd nodig heeft, hoewel dit eerder een workaround is dan een echte oplossing. Zie [PHP-extensies en -instellingen](https://support.kapsulehost.com/nl-nl/php-extensions-and-ini).

Let op het verschil: als PHP eerst zijn eigen uitvoeringslimiet bereikt, krijg je een 500, geen 504. Beide betekenen "te traag", maar op verschillende lagen.

## Helemaal geen reactie

Soms is er geen foutcode, omdat er geen reactie is. De verbinding blijft gewoon hangen en verloopt uiteindelijk.

Als dit vanaf één netwerk gebeurt maar de site werkt vanaf een ander netwerk, en vooral vanaf een telefoon met mobiele data, is de meest waarschijnlijke oorzaak een automatische misbruikblokkering: een reeks fouten of mislukte inlogpogingen vanaf jouw adres heeft een tijdelijk netwerkniveau-verbod geactiveerd. Deze verdwijnen vanzelf, meestal binnen een uur. Als je het eerder opgeheven wilt hebben, neem dan contact op met support en geef het IP-adres door waarmee je verbinding maakt.

## Aangepaste foutpagina's

Je kunt de standaard foutpagina voor 400, 401, 403, 404, 500, 502, 503 en 504 vervangen door je eigen HTML, onder **Websites**, de site, **Instellingen**, dan **Foutpagina's**. KapsuleHost levert standaardpagina's in eigen huisstijl voor 404, 500, 502, 503 en 504 als je dit niet zelf doet.

Eén ding om te weten: een aangepaste foutpagina behoudt de echte statuscode. Een aangepaste 404 geeft nog steeds 404 terug. Je foutpagina serveren met een 200-status is een klassieke manier om je posities in zoekmachines te ruïneren, en dit is hier bewust niet mogelijk. Zie [Aangepaste foutpagina's](https://support.kapsulehost.com/nl-nl/site-error-pages).

## Gerelateerde handleidingen

- [Website laadt niet](https://support.kapsulehost.com/nl-nl/website-not-loading)
- [Foutlogs](https://support.kapsulehost.com/nl-nl/error-logs)
- [Traagheid van de site en resourcelimieten](https://support.kapsulehost.com/nl-nl/site-slow-resource-limits)
- [Status en uptime](https://support.kapsulehost.com/nl-nl/status-and-uptime)
- [Websites](https://support.kapsulehost.com/nl-nl/sites-overview)
- [Hostingwoordenlijst](https://support.kapsulehost.com/nl-nl/glossary)