Tietokantayhteys epäonnistui WordPressissä: mitä virhe tarkoittaa

Mitä ilmoitus tarkoittaa

Jokaista näyttämäänsä sivua varten WordPress avaa yhteyden MySQL- tai MariaDB-tietokantaansa neljällä tiedolla, jotka on kirjoitettu sivuston juurihakemiston wp-config.php-tiedostoon:

define( 'DB_NAME', 'tietokannan_nimi' );
define( 'DB_USER', 'kayttajanimi' );
define( 'DB_PASSWORD', 'salasana' );
define( 'DB_HOST', 'localhost' );

”Tietokantayhteys epäonnistui” tarkoittaa, että tämä yhteys ei onnistunut. Sen aiheuttaa jokin neljästä syystä: tunnukset, jotka eivät enää täsmää, tietokantapalvelin, joka on pysähtynyt tai jota ei tavoiteta, ylikuormittunut palvelin tai vaurioitunut tietokanta. Seuraavat osiot käyvät ne läpi helpoimmin tarkistettavasta harvinaisimpaan.

1. Vastaako tietokantapalvelin?

• Webhotellin tilasivu: MySQL-palvelimen häiriö tai huoltokatko ilmoitetaan siellä.
• Saman tilin muut sivustot: jos niissä näkyy sama virhe samaan aikaan, syy on palvelimessa, ja korjaus tehdään webhotellin puolella.
• phpMyAdmin webhotellin hallintapaneelista: jos se avaa tietokannan ja näyttää sen taulut, palvelin toimii ja tietokanta on olemassa.

Jos vika on palvelimessa, avatkaa tukipyyntö webhotelliin ja kertokaa, milloin vika alkoi, sekä tarkka virheilmoitus. Sivustoon ei sillä välin tarvitse tehdä muutoksia.

2. Ovatko wp-config.php-tiedoston tunnukset oikein?

Tämä on yleisin syy sivuston siirron, tietokannan salasanan vaihdon tai varmuuskopion palautuksen jälkeen. Verratkaa wp-config.php-tiedoston neljää arvoa webhotellin hallintapaneelin tietokantaosioon:

• DB_NAME ja DB_USER: monet webhotellit lisäävät niihin tilin nimen etuliitteeksi (tili_wordpress). Etuliite on osa nimeä.
• DB_PASSWORD: jos olette epävarmoja, asettakaa käyttäjälle hallintapaneelissa uusi salasana ja kopioikaa se tiedostoon.
• DB_HOST: monessa webhotellissa localhost, mutta ei kaikissa. Osa antaa palvelimen nimen tai osoitteen, jota joskus seuraa portti (:3306). Tarkka arvo löytyy hallintapaneelista.
• Käyttäjällä on oltava oikeudet tietokantaan: tarkistakaa hallintapaneelista, että käyttäjä on liitetty tietokantaan kaikilla oikeuksilla.

Heittomerkin (') sisältävä salasana katkaisee sitä ympäröivän PHP-merkkijonon wp-config.php-tiedostossa. Lisätkää sen eteen kenoviiva (\') tai valitkaa salasana, jossa heittomerkkiä ei ole.

Testatkaa tunnukset WordPressin ulkopuolella

WordPress näyttää yleisen ilmoituksen. MySQL sen sijaan kertoo tarkasti, mikä on vialla. Kaksi tapaa kysyä sitä wp-config.php-tiedoston arvoilla:

Komentoriviltä, jos teillä on SSH-yhteys

mysql -h localhost -u kayttajanimi -p tietokannan_nimi

WP-CLI:n komento wp db check lukee wp-config.php-tiedoston suoraan ja tarkistaa taulut näillä tunnuksilla.

Väliaikaisella PHP-tiedostolla

Tallentakaa tämä tiedosto sivuston juurihakemistoon vaikeasti arvattavalla nimellä, avatkaa se selaimessa ja poistakaa se heti: se sisältää tietokannan salasanan.

<?php
mysqli_report(MYSQLI_REPORT_OFF);
$yhteys = @mysqli_connect('localhost', 'kayttajanimi', 'salasana', 'tietokannan_nimi');
echo $yhteys ? 'Yhteys onnistui' : 'Virhe: ' . mysqli_connect_error();

Ensimmäinen rivi on tärkeä: PHP 8.1:stä lähtien epäonnistunut yhteys aiheuttaa oletuksena poikkeuksen, ja sivu jäisi tyhjäksi MySQL:n viestin sijaan.

3. Vaurioitunut tietokanta: korjaustyökalu

Kun tunnukset ovat oikein mutta tauluja on vaurioitunut, julkinen sivusto näyttää saman yhteysvirheen ja hallintapaneeli tarkemman ilmoituksen: ”Yksi tai useampi tietokantataulu ei ole saatavilla. Tietokanta voi vaatia korjausta.” WordPressissä on tähän työkalu. Lisätkää tämä rivi wp-config.php-tiedostoon:

define( 'WP_ALLOW_REPAIR', true );

Avatkaa sitten https://www.sivustonne.com/wp-admin/maint/repair.php ja valitkaa ”Korjaa tietokanta”. Poistakaa rivi heti, kun korjaus on valmis: niin kauan kuin se on paikallaan, kuka tahansa pääsee sivulle kirjautumatta.

Ennen korjausta viekää tietokanta talteen (wp db export tai phpMyAdminin vientitoiminto). Jos korjaus epäonnistuu, webhotelli voi palauttaa tietokannan varmuuskopioistaan.

4. Virhe, joka tulee ja menee: kuormitus

Virhe, joka ilmestyy tiettyinä aikoina ja katoaa itsestään, viittaa ylikuormittuneeseen palvelimeen eikä väärään asetukseen. Yleisimmät syyt:

• Liikennepiikki, usein botit: toistuvat kirjautumisyritykset osoitteisiin wp-login.php tai xmlrpc.php, jotka näkyvät webhotellin käyttölokeissa.
• Jaetun webhotellin rajat: samanaikaisten yhteyksien tai prosessien määrä on rajattu tiliä kohti. Webhotellin hallintapaneeli näyttää ne yleensä resurssien käyttöä koskevassa osiossa.
• Raskas lisäosa: tilastot, lokit tai ajastetut tehtävät, jotka kirjoittavat tietokantaan jokaisella käynnillä.

Korjaukset: estäkää väärinkäyttävät kirjautumisyritykset, ottakaa käyttöön sivujen välimuisti, poistakaa xmlrpc.php käytöstä, jos mikään sovellus ei käytä sitä, ja pyytäkää webhotellilta lokit virheen ajankohdalta.