Kun WordPress näyttää pelkän lauseen Error establishing a database connection, sivuston tiedostot ovat tallessa ja sisältö on tietokannassa. Yhteys näiden kahden välillä ei vain synny. Se on hyvä uutinen, koska mitään ei ole hävinnyt, mutta huono uutinen siinä mielessä että sivusto on kokonaan pois käytöstä siihen asti kunnes yhteys palautuu.
Avaa /wp-admin. Jos sielläkin lukee sama virhe, yhteys puuttuu kokonaan. Jos hallinta kertoo että tietokanta pitää korjata, kyse on vioittuneesta taulusta eikä yhteydestä, ja silloin siirry suoraan kohtaan 4.
Sivuston juuressa oleva wp-config.php sisältää neljä riviä joilla yhteys muodostetaan. Ne ovat tietokannan nimi, käyttäjä, salasana ja palvelin. Yleisin yksittäinen syy on että joku vaihtoi tietokannan salasanan hallintapaneelista eikä päivittänyt sitä tähän tiedostoon. Vertaa arvoja webhotellin paneelin tietoihin merkki merkiltä. Ohje tietokannan tunnusten löytämiseen on tietokannan hallinnassa.
Palvelimen kohdalla arvo on tavallisesti localhost. Jos joku on vaihtanut sen IP-osoitteeksi tai etäpalvelimen nimeksi siirron yhteydessä, yhteys katkeaa vaikka kaikki muu olisi oikein.
Tietokantapalvelin voi kieltäytyä uusista yhteyksistä, jos niitä on auki liikaa. Tämä näkyy siten että sivusto toimii ajoittain ja kaatuu ruuhka-aikaan. Syynä on usein raskas lisäosa tai liikennepiikki. Jos oire vaihtelee tunneittain, kyse on lähes varmasti kuormasta eikä tunnuksista.
Odottamaton uudelleenkäynnistys voi jättää taulun kesken. WordPressissä on tätä varten oma korjaustila, joka otetaan käyttöön lisäämällä wp-config.php-tiedostoon rivi define('WP_ALLOW_REPAIR', true); ja avaamalla osoite /wp-admin/maint/repair.php. Poista rivi heti korjauksen jälkeen, koska sivu toimii ilman kirjautumista.
Täysi levy kaataa tietokannan ilman muuta varoitusta, koska tietokanta ei saa kirjoitettua omia väliaikaistiedostojaan. Katso hallintapaneelista paljonko tilaa on jäljellä. Tavallisin tilan syöjä on varmuuskopiolisäosa joka on tallentanut kopiot samalle levylle.
Siirrossa unohtuu helposti joko tietokannan tuonti tai käyttäjän oikeuksien myöntäminen uudessa paikassa. Tarkista että tietokanta on olemassa, että siinä on tauluja ja että käyttäjällä on oikeudet juuri siihen tietokantaan.
Älä asenna WordPressiä uudelleen. Uusi asennus tekee tyhjän tietokannan ja voi kirjoittaa vanhan päälle, jolloin sisältö menetetään oikeasti. Ota varmuuskopio ennen kuin kokeilet mitään, ks. sivuston varmuuskopiointi.
Selvitämme kumpi on kyseessä, katkennut yhteys vai vioittunut tietokanta, ja palautamme sivuston toimintaan. Tarkistamme myös miksi yhteys katkesi, koska sama syy toistuu muuten seuraavalla kuormapiikillä.
