Error establishing a database connection: cách sửa
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.
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.
- Đă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' ); - 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. DB_HOSTthườ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.- 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_PASSWORDvà lưu file.
Cách 2: Kiểm tra database và quyền của user trong cPanel
- Trong cPanel, mở Manage My Databases. Ở bảng Current Databases, tìm database trùng
DB_NAMEvà xem cột Privileged Users có user trùngDB_USERkhông.
Cột Privileged Users liệt kê user đã được gán quyền vào database đó. - 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.

Chọn user ở ô trên, database ở ô dưới, rồi bấm Add để sang bước chọn quyền. - 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_PASSWORDtrongwp-config.phpcho 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.phpcủ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.
- 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 ); - Mở
https://website-cua-ban.vn/wp-admin/maint/repair.phpvà bấm 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. - Xong thì xoá ngay dòng
WP_ALLOW_REPAIRkhỏiwp-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
- Chuyển host xong web WordPress bị lỗi: nguyên nhân và cách sửa
- Lỗi 500 Internal Server Error trên WordPress: cách sửa
- There has been a critical error on this website: cách sửa
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.