Przejdź do treści
Jak użyć wbudowanego trybu naprawy i optymalizacji bazy WordPress

Jak użyć wbudowanego trybu naprawy i optymalizacji bazy WordPress

Opublikowano: 18 października 2026| Zaktualizowano: 18 października 2026

Awaria tabel bazy danych może zablokować panel WordPressa i utrudnić diagnozę. Wbudowany tryb naprawy może pomóc przy wybranych problemach z tabelami, ale jego skuteczność zależy między innymi od ich silnika.

Krótka odpowiedź

Wbudowany tryb naprawy włączysz przez dodanie w pliku wp-config.php stałej WP_ALLOW_REPAIR ustawionej na true, a następnie otwarcie adresu /wp-admin/maint/repair.php. Przed uruchomieniem wykonaj kopię bazy i sprawdź silnik tabel, ponieważ MySQL nie obsługuje REPAIR TABLE dla tabel InnoDB.

Po zakończeniu usuń stałą z wp-config.php i sprawdź, czy strona naprawy nie udostępnia już operacji.

Usługi KC Mobile

Potrzebujesz pomocy w tym temacie?

Czytasz poradnik „Jak użyć wbudowanego trybu naprawy i optymalizacji bazy WordPress”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny.

Co robi wbudowany tryb naprawy WordPress?

Wbudowany tryb naprawy udostępnia skrypt WordPressa do sprawdzenia i naprawy tabel bazy oraz ich optymalizacji, ale nie naprawia każdego rodzaju tabeli ani całej witryny. Skrypt znajduje się pod adresem /wp-admin/maint/repair.php, a jego uruchomienie wymaga stałej WP_ALLOW_REPAIR w pliku wp-config.php.

Skuteczność operacji naprawy zależy od silnika tabel. MySQL 8.4 dopuszcza REPAIR TABLE dla tabel MyISAM, ARCHIVE i CSV, ale nie dla InnoDB. InnoDB jest domyślnym silnikiem nowych tabel w MySQL 8.4. W przypadku tabel InnoDB komunikat z repair.php trzeba ocenić według silnika i wyniku MySQL; nie należy zakładać, że skrypt naprawił tabelę. Dokumentację MySQL sprawdziliśmy w październiku 2026 r.

Tryb nie poprawi błędnego hasła do bazy, niedostępnego serwera MySQL, uszkodzonych plików PHP ani błędów wtyczki. Optymalizacja tabel nie diagnozuje również wolnych zapytań, nadmiaru opcji ładowanych automatycznie ani dużego ruchu.

Dokumentacja WordPressa wskazuje, że strona naprawy nie wymaga logowania, ponieważ może być potrzebna przy braku dostępu do panelu. Włącz stałą tylko na czas pracy i usuń ją po zakończeniu. Informacje o WP_ALLOW_REPAIR i ścieżce skryptu sprawdziliśmy w październiku 2026 r.

Tabela pomaga dobrać pierwsze działanie do objawu.

objawy problemów WordPressa i pierwsze działanie diagnostyczne
ObjawMożliwe znaczeniePierwsze działanie
Komunikat o niedostępnych tabelachTabela może wymagać diagnozyWykonaj kopię i sprawdź silnik tabel
Error establishing a database connectionBrak połączenia z baząSprawdź dane połączenia i serwer
Wolne ładowanie podstronZapytania, hosting lub zasobyZmierz czas i sprawdź logi
Błąd po aktualizacjiKonflikt kodu lub przerwana aktualizacjaSprawdź logi, wersje i kopię

Użyj naprawy tabel przy objawie tabelarycznym, a połączenie i wydajność diagnozuj osobno. Przy szerszej awarii przydatna jest diagnoza problemów z bazą danych WordPress.

Czytasz poradnik „Jak użyć wbudowanego trybu naprawy i optymalizacji bazy WordPress”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny. Omów temat tego poradnika

Kiedy uruchamiać naprawę bazy?

Uruchom tryb naprawy, gdy WordPress lub serwer zgłasza problem z konkretną tabelą bazy danych. Sam komunikat o problemie z połączeniem nie potwierdza uszkodzenia tabeli, ponieważ przyczyną mogą być błędne dane dostępowe albo awaria serwera.

Tabela oddziela sytuacje, w których naprawa tabel może być właściwym krokiem, od przypadków wymagających innej diagnozy.

dobór pierwszego działania do rodzaju usterki WordPressa
SytuacjaNaprawa tabel jako pierwszy krokWłaściwe pierwsze działanie
Komunikat wskazuje uszkodzoną tabelęTak, po kopii i sprawdzeniu silnikaZapisz komunikat i wykonaj kopię
Błąd połączenia z baząNieSprawdź DB_NAME, DB_USER, DB_PASSWORD i DB_HOST
Błąd PHP po aktualizacji wtyczkiNieSprawdź logi i konflikt rozszerzeń
Wolne zapytania lub długi czas odpowiedziNie jako jedyne działanieZmierz czas i przeanalizuj zapytania
Brak tabel po migracjiNie bez sprawdzenia kopiiPorównaj prefiks tabel i wynik importu

Zatrzymaj procedurę, jeśli nie masz kopii, nie możesz potwierdzić właściwej instalacji albo serwer zgłasza błędy podczas operacji. Zapisz komunikaty przed dalszą diagnozą. Gdy awaria obejmuje pliki lub konfigurację, pomoc w naprawie WordPressa może objąć szerszy zakres.

Jak przygotować kopię i dostęp do plików?

Przed zmianą wp-config.php wykonaj kopię bazy i potwierdź, że można ją odtworzyć. Sam plik eksportu nie dowodzi, że kopia jest kompletna ani że dotyczy właściwej witryny.

Przygotuj kopię i dostęp w tej kolejności:

1. Zapisz dokładny komunikat błędu, adres strony i godzinę wystąpienia.
2. Wykonaj kopię bazy z panelu hostingu, phpMyAdmin lub używanego narzędzia backupowego.
3. Sprawdź nazwę bazy i prefiks tabel w konfiguracji witryny, aby nie pracować na innej instalacji.
4. Potwierdź możliwość odtworzenia kopii w środowisku testowym lub skorzystaj ze sprawdzonego procesu hostingu.
5. Przygotuj dostęp do katalogu WordPressa przez menedżer plików hostingu albo SFTP.

Przed uruchomieniem repair.php sprawdź silniki tabel. W phpMyAdmin otwórz właściwą bazę i odczytaj kolumnę Type przy tabelach. Administrator może również użyć MySQL do sprawdzenia definicji konkretnej tabeli, na przykład polecenia SHOW CREATE TABLE nazwa_tabeli. W MySQL 8.4 REPAIR TABLE dotyczy MyISAM, ARCHIVE i CSV, a nie InnoDB; przy mieszanych silnikach wynik należy ocenić dla każdej tabeli oddzielnie. Źródłem tej informacji jest dokumentacja MySQL 8.4, sprawdzona w październiku 2026 r.

Plik wp-config.php znajduje się w katalogu instalacji WordPressa i zawiera ustawienia połączenia z bazą. Pobierz jego kopię przed edycją, zachowaj oryginalne kodowanie i nie usuwaj istniejących definicji. Rejestruj czas wykonania kopii i wprowadzonych zmian.

Schemat pokazuje przygotowania przed naprawą: zapis objawu, kopię, potwierdzenie instalacji, kontrolę silników i dostęp do plików.

Jak włączyć tryb naprawy przez wp-config.php?

Tryb naprawy włączysz, dodając do wp-config.php definicję WP_ALLOW_REPAIR ustawioną na true. Po zapisaniu pliku otwórz adres https://twoja-domena.pl/wp-admin/maint/repair.php, podstawiając własną domenę.

Dodaj linię:

define( 'WP_ALLOW_REPAIR', true );

Umieść definicję w sekcji konfiguracji przed komentarzem kończącym edycję wp-config.php, zwykle przed linią That's all, stop editing! Happy publishing. Jeśli stała już występuje w pliku, nie dodawaj jej ponownie. Dokumentacja WordPressa zaleca wyłączyć funkcję, gdy problem zostanie rozwiązany.

Po otwarciu strony WordPress pokaże dostępne działania naprawy. Dokumentacja WordPressa potwierdza, że strona nie wymaga zalogowania; dlatego nie przekazuj jej adresu osobom postronnym i nie pozostawiaj aktywnej stałej. Informacje sprawdziliśmy w październiku 2026 r.

Jeżeli strona nadal prosi o dodanie stałej, sprawdź, czy edytujesz wp-config.php właściwej instalacji, zapisujesz plik w odpowiednim katalogu i czy serwer odczytuje aktualną wersję. Przy błędzie składni PHP przywróć kopię pliku i popraw zmianę przed kolejną próbą.

Jak przeprowadzić naprawę i optymalizację?

Naprawę uruchamiaj po potwierdzeniu problemu z tabelą, a optymalizację wybieraj tylko wtedy, gdy znasz jej zakres i masz kopię bazy. Przed kliknięciem operacji sprawdź silnik każdej tabeli i porównaj wynik narzędzia z komunikatem MySQL.

Strona repair.php udostępnia opcję naprawy oraz opcję naprawy połączonej z optymalizacją tabel. Zapisz wybrany wariant i komunikaty zwrócone przy tabelach. MySQL 8.4 obsługuje REPAIR TABLE dla MyISAM, ARCHIVE i CSV, ale nie dla InnoDB; przy tabeli InnoDB nie uznawaj samego komunikatu skryptu za potwierdzenie naprawy. Dokumentacja MySQL zaleca dla niektórych problemów InnoDB odbudowę przez eksport i ponowne wczytanie albo postępowanie właściwe dla konkretnego komunikatu. Zleć ocenę administratorowi bazy lub hostingowi, jeśli wynik jest niejednoznaczny.

Tabela ułatwia odczyt typowych wyników, ale nie zastępuje oceny silnika i komunikatu MySQL.

interpretacja wyników naprawy bazy WordPress
WynikZnaczenieNastępne działanie
Naprawa zakończona bez błęduSkrypt nie zgłosił błędu operacjiSprawdź silnik i działanie witryny
Tabela naprawionaNarzędzie zgłosiło wynik naprawyZweryfikuj funkcje korzystające z tabeli
Tabela nie istniejeBaza nie zawiera wskazanej tabeliSprawdź prefiks i kompletność migracji
Operacja zakończona błędemNaprawa nie została potwierdzonaZachowaj komunikat i skontaktuj się z hostingiem
Strona nie kończy pracyMożliwy problem bazy lub serweraNie ponawiaj bez kopii i diagnozy

Przerwij, jeśli tabela InnoDB nadal zgłasza problem, narzędzie zwraca błąd albo operacja nie kończy pracy. Po zakończeniu sprawdź stronę główną, logowanie do wp-admin, edycję wpisu i zapis formularza lub zamówienia.

Jak wyłączyć tryb po zakończeniu?

Wyłącz tryb naprawy, usuwając definicję WP_ALLOW_REPAIR z wp-config.php natychmiast po zakończeniu operacji. Strona naprawy nie usuwa stałej automatycznie, a jej pozostawienie może udostępniać narzędzie bez logowania.

Usuń linię, zapisz plik i sprawdź działanie witryny. Otwórz /wp-admin/maint/repair.php w prywatnym oknie przeglądarki. Strona nie powinna udostępniać przycisków naprawy ani optymalizacji; może wyświetlić informację o konieczności włączenia trybu lub odmowę dostępu.

Tabela zawiera kontrolę zamknięcia dostępu i podstawowych funkcji po operacji.

kontrola po zakończeniu naprawy bazy WordPress
Element kontroliOczekiwany wynikDowód do zapisania
WP_ALLOW_REPAIRBrak definicji w wp-config.phpKopia zmienionego pliku
Adres repair.phpBrak dostępnych operacjiZapisany komunikat odmowy
Strona głównaŁaduje się poprawnieData i wynik kontroli
Panel administracyjnyMożna się zalogowaćWynik próby logowania
Funkcja biznesowaFormularz lub koszyk działaWynik próby zapisu

Procedura jest zamknięta, gdy stała nie występuje w konfiguracji, a strona naprawy nie udostępnia operacji.

Lista kontrolna potwierdza usunięcie dostępu do naprawy oraz działanie strony, panelu administracyjnego i funkcji biznesowej.

Co zrobić, gdy naprawa nie pomaga?

Jeśli naprawa nie przywróci działania, zachowaj komunikaty i sprawdź połączenie, silnik tabel, uprawnienia oraz logi serwera. Nie ponawiaj operacji, gdy wynik jest niejednoznaczny albo nie możesz odtworzyć kopii.

Sprawdź kolejno:

  • Czy DB_NAME, DB_USER, DB_PASSWORD i DB_HOST w wp-config.php wskazują właściwą bazę i konto.
  • Czy baza odpowiada w panelu hostingu lub phpMyAdmin.
  • Czy prefiks tabel w wp-config.php odpowiada nazwom w bazie.
  • Czy log PHP, serwera WWW lub bazy zawiera błąd z czasu awarii.
  • Czy tabela używa silnika zgodnego z operacją naprawy.

Dokumentacja WordPressa wskazuje, że błąd Error establishing a database connection może wynikać z błędnych ustawień wp-config.php albo problemu po stronie hostingu. Dokumentacja MySQL opisuje osobne metody postępowania z tabelami InnoDB i MyISAM; dobór metody zależy od silnika oraz komunikatu. Obie dokumentacje sprawdziliśmy w październiku 2026 r.

Jeżeli strona wyświetla błąd 500, sprawdź log PHP i ostatnie zmiany wtyczek, motywu lub wersji PHP przed następną modyfikacją bazy. Pomocna może być procedura diagnozowania błędu 500 w WordPressie. Gdy awaria blokuje klientów lub sprzedaż, zlecenie naprawy WordPressa może objąć diagnostykę plików, konfiguracji i bazy.

Czy optymalizacja bazy przyspieszy WordPress?

Optymalizacja tabel może zmienić sposób przechowywania danych przez silnik bazy, ale sama nie gwarantuje szybszego WordPressa. Czas ładowania zależy też od zapytań, serwera, wtyczek, pamięci podręcznej i danych ładowanych przy każdym żądaniu.

Najpierw zmierz, która część witryny działa wolno, a dopiero potem dobierz działanie. Optymalizacja tabel nie usuwa automatycznie starych wpisów, transientów ani nadmiarowych opcji w wp_options. Nie poprawia też zapytania wykonywanego przez wtyczkę przy każdym wejściu na stronę.

Tabela łączy objaw z kierunkiem diagnozy.

objawy wydajności WordPressa i kierunek diagnozy
ObjawCo sprawdzićKierunek diagnozy
Wolny panel administracyjnyCzas odpowiedzi i logi PHPWtyczki, zapytania i serwer
Wolna karta produktuCzas zapytań i cacheZapytania WooCommerce i pamięć podręczna
Duża tabela wp_optionsOpcje ładowane automatycznieWłaściciel opcji i sposób ładowania
Baza rośnie po migracjiLiczbę i rozmiar tabelPozostałości po wtyczkach i migracji
Problem z jedną tabeląKomunikat MySQL i silnikMetoda naprawy lub odtworzenie kopii

Optymalizuj po pomiarze przyczyny spowolnienia; tryb naprawy służy do diagnozy problemów tabel, a nie jako ogólny zabieg przyspieszający stronę.

Perspektywa KC Mobile: sama optymalizacja tabel nie zastępuje sprawdzenia zapytań wykonywanych przez sklep i wtyczki. Zalecamy wskazać wolny widok i przejrzeć logi przed zmianami w bazie.

Więcej poradników w tym temacie

Wspomniane narzędzia

WordPressWP_ALLOW_REPAIRwp-config.phpphpMyAdminSFTPMySQLWP-CLI

Najczęściej zadawane pytania

Jak włączyć wbudowany tryb naprawy bazy WordPress?
Dodaj do wp-config.php linię define( 'WP_ALLOW_REPAIR', true );, zapisz plik i otwórz adres /wp-admin/maint/repair.php swojej witryny. Przed operacją wykonaj kopię bazy i sprawdź silnik tabel.
Gdzie wstawić WP_ALLOW_REPAIR?
Dodaj stałą w sekcji definicji pliku wp-config.php, przed komentarzem kończącym edycję pliku. Sprawdź najpierw, czy WP_ALLOW_REPAIR nie występuje już w konfiguracji.
Czy do strony naprawy trzeba się zalogować?
Nie. Po włączeniu WP_ALLOW_REPAIR strona naprawy nie wymaga logowania, dlatego usuń stałą z wp-config.php zaraz po zakończeniu pracy.
Czy optymalizacja bazy WordPress może przyspieszyć stronę?
Optymalizacja może zmienić stan tabel, ale nie diagnozuje automatycznie wolnych zapytań, nadmiarowych opcji ani konfiguracji serwera. Najpierw zmierz, która część witryny działa wolno.
Co zrobić, gdy naprawa bazy WordPress nie działa?
Zachowaj komunikat, nie ponawiaj operacji bez kopii i sprawdź połączenie, prefiks oraz silnik tabel. Przy problemie z InnoDB lub niejednoznacznym wyniku skonsultuj komunikat z hostingiem albo administratorem bazy.
#WordPress#baza danych WordPress#naprawa bazy WordPress#WP_ALLOW_REPAIR#wp-config.php#optymalizacja bazy danych#phpMyAdmin#bezpieczeństwo WordPress
Zdjęcie autora: Krzysztof Czapnik
O autorze

Krzysztof Czapnik

Founder & Technical Lead, KC Mobile

Projektuję i rozwijam strony WordPress, sklepy WooCommerce oraz aplikacje internetowe. Łączę projektowanie z programowaniem, integracjami i technicznym SEO. Projekty KC Mobile prowadzę osobiście.

Potrzebujesz pomocy z tym tematem? Napisz - odpowiem osobiście w 24h.

Potrzebujesz pomocy w tym temacie?

Czytasz poradnik „Jak użyć wbudowanego trybu naprawy i optymalizacji bazy WordPress”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny.