Khắc phục Recovery Install không launch được

URL recovery không mở được hoặc installer crash.

SL MigrationsCập nhật 21/10/2026
recoverytroubleshoot

Recovery Install không launch được

Triệu chứng

  • Click URL recovery → 404
  • Installer mở ra nhưng lỗi PHP fatal
  • Step 1 báo "Cannot find archive"

Nguyên nhân + Cách fix

1. URL recovery hết hạn

Recovery Point chỉ hợp lệ khi backup tương ứng còn tồn tại và status Complete. Nếu backup đã bị xóa hoặc bị chạy đè lên, URL cũ không còn hiệu lực.

Fix: vào SL Migrations → Packages, set Recovery Point trên backup mới nhất, lấy URL mới.

2. Folder backups-slm/ không readable

Web server không đọc được folder backup → 404 hoặc 403.

Fix: Đặt quyền cho folder backup đúng (thường là 755 cho folder và đảm bảo owner là user của web server). Liên hệ hosting nếu không có quyền chỉnh.

3. File archive bị xóa

Recovery URL load recovery-installer.php đọc archive trong cùng folder. Nếu archive bị xóa (manual hoặc do rotation rule), recovery fail.

Fix: Kiểm tra folder, nếu mất → không recover được. Cần backup khác.

4. PHP version quá cũ

Installer yêu cầu PHP >= 7.4. Server đích < 7.4 → fatal.

Fix: Upgrade PHP. Trên shared hosting có thể switch PHP version trong cPanel/Plesk.

5. Database credentials không còn đúng

Recovery dùng credentials trong wp-config.php hiện tại. Nếu database đổi password gần đây mà wp-config cũ → fail step 2.

Fix: Sửa wp-config.php trên server, cập nhật password đúng trước khi chạy recovery.

Khi mọi cách fail

Recovery Point là tính năng convenience. Backup chính vẫn còn - có thể:

  1. Tải archive + installer.php từ folder backup về máy
  2. Chạy Classic Install thông thường
  3. Mất thêm vài bước nhưng đảm bảo hơn

Tham khảo

Lưu ý bảo mật (từ 1.8.9)

Khuyến nghị cấu hình nginx chặn truy cập trực tiếp thư mục wp-content/backups-slm/ (trả 404) để không ai tải được bản backup (kèm database) qua đường dẫn web, chỉ chừa file *_log.txt cho nút Xem log. Trên máy chủ đã áp luật này, nút Tải backup trong admin vẫn chạy vì đi qua admin-ajax có token hết hạn sau 1 giờ.

Vì vậy link Recovery Point dạng https://<site>/wp-content/backups-slm/recover/... sẽ không mở được. Khi thật sự cần dùng Recovery Point: nhờ quản trị máy chủ mở tạm thư mục backups-slm/recover/ (luật chặn thư mục backup trong cấu hình nginx), khôi phục xong thì xoá Recovery Point và chặn lại ngay. Cách an toàn hơn là khôi phục bằng Import Install hoặc Classic Install từ bản backup lưu ở đích từ xa (SFTP/FTP).