WordPress

Sửa lỗi Error establishing a database connection khi chuyển hosting

6 phút đọc
Mục lục bài viết

    Để sửa lỗi Error establishing a database connection khi chuyển hosting, hãy đối chiếu bốn giá trị DB_NAME, DB_USER, DB_PASSWORD, DB_HOST trong wp-config.php với thông tin trên hosting mới. Đây là nguyên nhân phổ biến được nhiều tài liệu nhắc tới. Các bước dưới đây đi từ kiểm tra nhanh đến khôi phục sao lưu.

    Sửa lỗi Error establishing a database connection khi chuyển hosting: lỗi này nghĩa là gì

    Thông báo này thường có nghĩa là WordPress không đọc được thông tin trong wp-config.php hoặc không kết nối được máy chủ MySQL/MariaDB. Khi PHP không giao tiếp được với MySQL, WordPress không lấy được nội dung và cài đặt, nên mọi trang đều ngừng hoạt động, kể cả wp-admin.

    Lỗi xuất hiện đúng lúc chuyển host vì DB_HOST, DB_USER và DB_NAME của máy chủ cũ thường không còn khớp với máy chủ mới. Người dùng gặp lỗi kết nối database wordpress này dưới dạng một dòng chữ trên nền trắng, tức là wordpress trang trắng sau khi chuyển host. Nếu có cache trang, khách truy cập có thể chưa thấy lỗi ngay, nên đừng vội kết luận site vẫn ổn.

    Trước khi thao tác, hãy sao lưu toàn bộ file và database hiện có. Nếu đã có bản sao lưu gần nhất, giữ nguyên để dùng khi cần khôi phục.

    Đối chiếu thông tin trong wp-config.php với hosting mới

    Bước đầu tiên là sửa lỗi wp-config.php bằng cách so khớp từng giá trị với bảng điều khiển hosting mới. Thông tin đăng nhập database sai trong tệp này là nguyên nhân cần loại trừ trước tiên.

    1. Mở trang quản lý database trên hosting mới và ghi lại tên database, tên người dùng, mật khẩu.
    2. Mở wp-config.php bằng trình quản lý tệp hoặc FTP, đối chiếu DB_NAME, DB_USER, DB_PASSWORD.
    3. Lưu tệp và tải lại website để xem lỗi có biến mất không.

    Tên database và người dùng hay bị thiếu tiền tố do nhà cung cấp tự thêm vào, ví dụ phần định danh tài khoản đứng trước tên bạn đặt. Hãy chép đúng chuỗi hiển thị trong bảng điều khiển, không gõ lại theo trí nhớ.

    Với DB_HOST, giá trị thường là localhost hoặc 127.0.0.1, nhưng cần xác nhận với nhà cung cấp. Một số host dùng máy chủ database riêng, khi đó phải ghi đúng tên máy chủ và cổng. Nếu localhost không hoạt động, có thể thử 127.0.0.1 như một phương án phụ vì giá trị này buộc dùng kết nối TCP.

    sửa lỗi Error establishing a database connection khi chuyển hosting — Tệp wp-config.php chứa thông tin DB_NAME, DB_USER, DB_PASSWORD, DB_HOST
    Bốn giá trị đăng nhập database cần đối chiếu trong wp-config.php

    Kiểm tra quyền người dùng và kết nối thực tế

    Nếu thông tin đã khớp mà database wordpress không kết nối, nguyên nhân tiếp theo thường là người dùng chưa được gán quyền. Người dùng database phải được gán đầy đủ quyền trong phần MySQL Databases của cPanel.

    Có thể tạo người dùng và mật khẩu mới trong cPanel rồi thêm vào đúng database với quyền All Privileges. Sau đó cập nhật lại DB_USER và DB_PASSWORD trong wp-config.php. Chỉ đổi DB_HOST là chưa đủ: tên database, người dùng và quyền cũng phải khớp.

    Thông báo Cannot select database cho biết tài khoản đúng nhưng tên database không tồn tại hoặc người dùng không có quyền dùng. Đây là dấu hiệu rõ để quay lại bước gán quyền.

    Để kiểm tra kết nối, có thể dùng một tệp PHP riêng và xóa ngay sau khi chạy vì tệp chứa mật khẩu dạng văn bản. Theo Sucuri, cách an toàn hơn là dùng lệnh wp db check hoặc mysql client qua SSH.

    Giao diện MySQL Databases trong cPanel để gán người dùng cho database
    Gán người dùng vào database với đầy đủ quyền trong cPanel

    Kiểm tra DNS, URL và trạng thái máy chủ database

    Nếu tên miền vẫn trỏ về host cũ, WordPress sẽ cố kết nối tới database cũ. Hãy kiểm tra nameserver và bản ghi DNS xem đã trỏ về host mới chưa. Thay đổi DNS cần thời gian cập nhật, nên có thể chưa thấy kết quả ngay.

    Sau khi chuyển host, cần cập nhật URL trong bảng wp_options bằng câu lệnh thay thế, và nên sao lưu database trước. Theo hướng dẫn của Hostinger, bước này giúp site không còn trỏ về địa chỉ của máy chủ cũ.

    Tiếp theo là trạng thái máy chủ. Hết dung lượng đĩa hoặc RAM có thể khiến MySQL bị dừng. Trên VPS, kiểm tra dịch vụ bằng systemctl và đọc log lỗi; có thể khởi động lại máy chủ để xóa lỗi tạm thời, nhưng nên sao lưu trước. Trên shared hosting, tài nguyên được dùng chung nên sự cố của site khác có thể ảnh hưởng đến database, vì vậy cần hỏi nhà cung cấp về giới hạn kết nối.

    Sơ đồ DNS và nameserver trỏ tên miền về máy chủ hosting
    Kiểm tra nameserver và DNS để tên miền trỏ đúng host mới

    Sửa bảng, thay file core và khôi phục sao lưu

    Khi thông tin đăng nhập và DNS đều đúng, hãy thử sửa bảng. Thêm dòng WP_ALLOW_REPAIR vào wp-config.php để mở trang sửa, và gỡ dòng này ngay sau khi xong vì trang sửa không yêu cầu đăng nhập. Với database cụ thể, lệnh mysqlcheck cũng có thể sửa bảng hỏng.

    Lệnh wp core verify-checksums giúp phát hiện file core bị thiếu hoặc bị sửa. Nếu cần thay file core, giữ nguyên wp-content và wp-config.php.

    Khi database hỏng nặng, tạo database mới, nhập bản sao lưu qua phpMyAdmin rồi cập nhật lại thông tin trong wp-config.php. Nếu vẫn lỗi, hãy quét mã độc vì mã độc có thể làm hỏng file hoặc database. Với lỗi chỉ xuất hiện lúc đông truy cập, bật cache trang và hỏi host về giới hạn kết nối.

    Giao diện phpMyAdmin dùng để nhập bản sao lưu database WordPress
    Nhập bản sao lưu database qua phpMyAdmin khi database hỏng nặng

    Sai lầm thường gặp

    Một sai lầm điển hình là chỉ đổi DB_HOST rồi dừng, trong khi tên database, người dùng và quyền vẫn chưa khớp. Nhiều người cũng gõ lại tên database thay vì chép nguyên chuỗi có tiền tố.

    Một lỗi khác là để quên tệp PHP kiểm tra kết nối hoặc dòng WP_ALLOW_REPAIR sau khi dùng, tạo lỗ hổng bảo mật. Ngoài ra, một số người sửa lỗi wp-config.php hay thay file core mà chưa sao lưu, và bỏ qua việc kiểm tra DNS nên WordPress vẫn kết nối về database cũ.

    Kết luận: quy trình sửa lỗi Error establishing a database connection khi chuyển hosting

    Thứ tự hợp lý khi sửa lỗi Error establishing a database connection khi chuyển hosting là: sao lưu, đối chiếu wp-config.php, kiểm tra quyền, kiểm tra DNS, rồi mới sửa bảng hoặc khôi phục. Bước nên làm tiếp theo là thiết lập sao lưu tự động, xem thêm bài tự động backup database hàng ngày bằng Cronjob.