Error establishing a database connection: cách sửa

SỬA LỖI

Cách sửa nhanh

Mở wp-config.php trong File Manager và đối chiếu 4 giá trị DB_NAME, DB_USER, DB_PASSWORD, DB_HOST với mục Manage My Databases (bản cPanel cũ tên là MySQL Databases) của hosting. Sai thì sửa cho khớp. Đúng hết mà vẫn lỗi thì máy chủ MySQL của hosting đang có vấn đề, liên hệ hosting kèm thời điểm bị lỗi.

Áp dụng cho: WordPress mọi phiên bản · hosting có cPanel hoặc DirectAdmin · không cần vào được trang quản trị

Nguyên nhân

“Error establishing a database connection” nghĩa là WordPress không kết nối được tới database chứa bài viết, tài khoản và cấu hình. Đừng cài lại WordPress hay nhập một database cũ khi chưa biết nguyên nhân, vì có thể mất dữ liệu mới.

Nguyên nhân Dấu hiệu nhận biết Cách sửa
Sai thông tin kết nối trong wp-config.php Vừa chuyển host hoặc đổi mật khẩu database; lỗi cả trang ngoài lẫn trang quản trị Cách 1
User chưa được gán quyền vào database Vừa tạo database hoặc user mới Cách 2
MySQL dừng, quá tải hoặc hosting hết dung lượng Lỗi lúc có lúc không; nhiều website cùng hosting cùng lỗi Cách 3
Bảng dữ liệu bị hỏng Trang quản trị báo database cần được sửa chữa Cách 4

Cách 1: Đối chiếu thông tin trong wp-config.php

Đây là nguyên nhân hay gặp nhất sau khi chuyển host hoặc đổi mật khẩu database.

Cảnh báo: Tải bản wp-config.php hiện tại về máy trước khi sửa. Không gửi các giá trị trong file này qua nhóm chat hay diễn đàn công khai.

  1. Đăng nhập cPanel hoặc DirectAdmin, mở File Manager, mở wp-config.php ở thư mục gốc website. Tìm 4 dòng sau:
    define( 'DB_NAME', 'ten_database' );
    define( 'DB_USER', 'ten_user' );
    define( 'DB_PASSWORD', 'mat_khau' );
    define( 'DB_HOST', 'localhost' );
  2. Mở mục Manage My Databases trong cPanel (bản cũ tên là MySQL Databases; hoặc mục quản lý MySQL của DirectAdmin) ở tab khác. So tên database và tên user với DB_NAME, DB_USER. Trên cPanel, cả hai thường có tiền tố là tên tài khoản hosting, ví dụ taikhoan_wp.
  3. DB_HOST thường là localhost. Một số hosting dùng tên máy chủ hoặc cổng riêng: kiểm tra trong trang quản lý database hoặc email bàn giao của hosting.
  4. Không chắc mật khẩu đúng thì đặt mật khẩu mới cho user ở Cách 2, rồi điền mật khẩu đó vào DB_PASSWORD và lưu file.

Cách 2: Kiểm tra database và quyền của user trong cPanel

  1. Trong cPanel, mở Manage My Databases. Ở bảng Current Databases, tìm database trùng DB_NAME và xem cột Privileged Users có user trùng DB_USER không.
    Bảng Current Databases trong cPanel, cột Privileged Users được khoanh đỏ, tiền tố tài khoản đã che
    Cột Privileged Users liệt kê user đã được gán quyền vào database đó.
  2. User chưa có trong cột đó: kéo xuống Add User To Database, chọn đúng user và database, bấm Add, rồi chọn ALL PRIVILEGES và bấm Make Changes.
    Khối Add User To Database trong cPanel với ô chọn User, ô chọn Database và nút Add, tiền tố tài khoản đã che
    Chọn user ở ô trên, database ở ô dưới, rồi bấm Add để sang bước chọn quyền.
  3. Cần đặt lại mật khẩu: ở bảng Current Users, bấm Change Password cạnh user đó, rồi cập nhật DB_PASSWORD trong wp-config.php cho khớp.

    Cảnh báo: Nếu nhiều website dùng chung user này, đổi mật khẩu sẽ làm tất cả mất kết nối cho tới khi bạn sửa wp-config.php của từng website. Không xoá database hay user cũ khi chưa biết website nào đang dùng chúng.

    Kiểm tra kết nối bằng WP-CLI

    wp config get DB_HOST
    wp db check

Cách 3: MySQL dừng, quá tải hoặc hết dung lượng

Thông tin đúng mà vẫn lỗi, nhất là lỗi lúc có lúc không, thì vấn đề nằm ở máy chủ database. Sửa file WordPress không giải quyết được trường hợp này.

  • Xem trang quản lý hosting có báo bảo trì MySQL, vượt tài nguyên hoặc tài khoản hết dung lượng không.
  • Nhiều website cùng hosting lỗi cùng lúc thì gần như chắc chắn là sự cố phía máy chủ.
  • Gửi hosting URL, thời điểm lỗi và nội dung thông báo. Đừng tải lại trang liên tục khi MySQL đang quá tải.

Cách 4: Sửa bảng dữ liệu bị hỏng

Chỉ dùng cách này khi trang quản trị báo database cần sửa chữa. Công cụ repair không sửa được sai mật khẩu, MySQL dừng hay database bị thiếu.

Nguy hiểm: Khi bật công cụ này, ai biết đường dẫn cũng mở được trang sửa chữa mà không cần đăng nhập. Xuất database (phpMyAdmin → Export) trước nếu còn đọc được, và xoá dòng cấu hình ngay sau khi sửa xong.

  1. Trong File Manager, thêm dòng sau vào wp-config.php, ngay trên dòng bắt đầu bằng /* That's all, stop editing!:
    define( 'WP_ALLOW_REPAIR', true );
  2. Mở https://website-cua-ban.vn/wp-admin/maint/repair.php và bấm Sửa cơ sở dữ liệu.
    Trang sửa chữa cơ sở dữ liệu của WordPress với nút Sửa cơ sở dữ liệu
    Bấm Sửa cơ sở dữ liệu, xong việc thì xoá ngay dòng cấu hình đã thêm.
  3. Xong thì xoá ngay dòng WP_ALLOW_REPAIR khỏi wp-config.php.

Nhiều bảng hỏng cùng lúc, hoặc hosting báo lỗi ổ đĩa, thì dừng lại và nhờ hosting hỗ trợ thay vì chạy repair nhiều lần.

Kiểm tra lại

Mở trang chủ và /wp-admin/ ở cửa sổ ẩn danh. Kiểm tra bài viết mới nhất, đơn hàng hoặc liên hệ gần nhất vẫn còn, để chắc website đang kết nối đúng database chứ không phải một bản cũ.

Câu hỏi thường gặp

“Lỗi kết nối tới cơ sở dữ liệu” là lỗi gì?

Đây là bản tiếng Việt của “Error establishing a database connection”, hiện trên website cài tiếng Việt. Lỗi giống hệt nhau, các cách sửa ở trên áp dụng y nguyên.

Có nên khôi phục backup database ngay không?

Không, nếu chưa biết nguyên nhân. Khôi phục database ghi đè mọi dữ liệu phát sinh sau thời điểm backup, như đơn hàng, bình luận, tài khoản mới. Phần lớn trường hợp chỉ cần sửa thông tin kết nối.

Lỗi liên quan

Không có bản database gần nhất, database báo hỏng nhiều bảng, hoặc website đang có đơn hàng liên tục? Cứu hộ web sửa lỗi website WordPress, gửi link để được kiểm tra miễn phí trước.

Tìm kiếm trên Cứu hộ web