WordPress 404 fout na migratie oplossen

Na een migratie van WordPress naar een nieuwe server zie je soms een 404-foutmelding op pagina’s die eerst prima werkten. Dit komt bijna altijd doordat de permalinkstructuur of het .htaccess-bestand niet correct is meegenomen, of doordat de database nog verwijst naar de oude omgeving. Door permalinks opnieuw op te slaan, het .htaccess-bestand te herstellen en de database-URL’s te controleren, is het probleem meestal binnen enkele minuten verholpen.

Waarom ontstaat een 404 fout na migratie

WordPress bouwt de URL-structuur van pagina’s en berichten op basis van instellingen die zijn opgeslagen in de database én op basis van herschrijfregels in het .htaccess-bestand. Bij een migratie wordt het .htaccess-bestand vaak niet overgezet, of de nieuwe server gebruikt een andere configuratie waardoor die regels niet meer werken. Daarnaast kan de siteURL in de database nog naar de oude locatie wijzen, waardoor links intern verkeerd worden opgebouwd. Het resultaat is dat de homepage meestal gewoon werkt, maar losse pagina’s, berichten of categorieën een 404 geven.

Permalinks herstellen

De snelste en meest voorkomende oplossing is het opnieuw opslaan van de permalinkinstellingen. WordPress schrijft dan automatisch de juiste herschrijfregels naar het .htaccess-bestand.

.htaccess controleren en aanpassen

Als het opnieuw opslaan van permalinks niet werkt, is het .htaccess-bestand mogelijk beschadigd, leeg of mist het de juiste rechten. Open het bestand via de bestandsbeheerder in Plesk en controleer of het begint met # BEGIN WordPress en eindigt met # END WordPress, met daartussen de standaard WordPress-herschrijfregels. Ontbreekt dit volledig, plak dan de standaardregels terug en sla het bestand op. Controleer ook of het bestand niet per ongeluk alleen-lezen staat; in Plesk pas je bestandsrechten eenvoudig aan via de bestandsbeheerder.

Draait je site op een server zonder Apache, zoals een LiteSpeed-omgeving, dan wordt .htaccess meestal automatisch correct geïnterpreteerd, maar het is alsnog verstandig te controleren of de juiste module actief is. Twijfel je over de serverconfiguratie, neem dan contact op via de support van je hostingprovider.

Database en URL’s checken

Soms ligt de oorzaak dieper: de velden siteurl en home in de tabel wp_options wijzen nog naar het oude domein of een oude submap. Dit controleer je via phpMyAdmin, bereikbaar vanuit Plesk. Zoek de rij met option_name ’siteurl‘ en ‚home‘ en vergelijk de waarde met het huidige domein. Klopt dit niet, pas de waarde dan aan naar de juiste URL inclusief https://.

Let ook op verwijzingen in de inhoud zelf, zoals afbeeldingen of interne links die nog naar het oude domein verwijzen. Een zoek-en-vervang-plugin kan dit in één keer corrigeren zonder dat je handmatig door elk bericht hoeft te gaan.

Wil je migratieproblemen in de toekomst voorkomen, overweeg dan te werken met een provider die migraties begeleidt. Bij overstappen naar Tandata wordt de omgeving zorgvuldig overgezet, inclusief database en bestandsstructuur. Daarnaast vind je in Plesk, onderdeel van elk webhosting-pakket, de bestandsbeheerder en phpMyAdmin overzichtelijk terug om dit soort controles snel uit te voeren.