Cập nhật WordPress thất bại hoặc làm hỏng website? Cách khôi phục

Bạn bấm Update, và có gì đó sai. Có thể bản cập nhật thất bại với “Update failed” hoặc “Could not create directory”. Có thể cập nhật xong, nhưng website hiện lỗi, giao diện vỡ, hoặc một tính năng không còn hoạt động. Cập nhật là lúc website WordPress hay hỏng nhất, và trong hầu hết trường hợp vấn đề có thể hoàn tác.

Hướng dẫn này gồm cả hai tình huống: cập nhật không cài được, và cập nhật đã cài nhưng làm hỏng website.

Bước 1: Xác định thứ đã thay đổi

Ghi lại những bản cập nhật nào đã chạy và chạy lúc nào. Nếu bạn cập nhật nhiều plugin cùng lúc, vấn đề gần như chắc chắn là một trong số đó. Hãy kiểm tra:

• Dashboard → Updates và trang Plugins để xem mục vừa được cập nhật.
• Hộp thư email. WordPress gửi thư sau cập nhật tự động, và sau lỗi nghiêm trọng WordPress gửi email “Your site is experiencing a technical issue”, thường nêu tên plugin hoặc theme và kèm liên kết recovery mode.
• Bảng điều khiển hosting, có thể ghi nhật ký cập nhật tự động hoặc bản sao lưu.

Bước 2: Nếu website hiện “Briefly unavailable for scheduled maintenance”

WordPress đưa website vào chế độ bảo trì khi cập nhật và tạo tệp tên .maintenance trong thư mục gốc. Nếu cập nhật dừng giữa chừng, tệp này còn lại và website bị khóa. Xóa .maintenance trong File Manager hoặc qua SFTP. Hướng dẫn sửa WordPress kẹt ở chế độ bảo trì của chúng tôi trình bày chi tiết, gồm cách hoàn tất bản cập nhật bị gián đoạn.

Bước 3: Nếu bản cập nhật không cài được

Các thông báo thường gặp và cách xử lý:

• “Could not create directory” hoặc “Destination folder already exists”: lần thử trước để lại tệp, hoặc WordPress không ghi được vào thư mục. Kiểm tra wp-content/upgrade và xóa các thư mục sót bên trong. Nếu thư mục plugin tồn tại nhưng plugin chưa đủ tệp, hãy xóa thư mục đó rồi cài lại plugin. Thư mục thường nên có quyền 755 và tệp 644.
• “Download failed” hoặc hết thời gian chờ: máy chủ không tới được WordPress.org hoặc hết thời gian. Thử lại sau, hoặc tải tệp ZIP của plugin rồi tải lên tại Plugins → Add New → Upload Plugin. Các phiên bản WordPress gần đây cho phép thay bản đã cài bằng bản vừa tải lên.
• “Update package not available”: điều này hay gặp với plugin và theme trả phí. Kiểm tra license key đã nhập và còn hiệu lực, hoặc tải bản mới nhất từ khu vực tài khoản của nhà cung cấp.
• Dung lượng đĩa: tài khoản hosting đầy khiến cập nhật thất bại theo cách khó lường. Kiểm tra dung lượng đĩa trong bảng điều khiển và xóa các bản sao lưu cũ đang nằm trên máy chủ.

Bước 4: Nếu bản cập nhật làm hỏng website

Nếu bạn thấy “There has been a critical error on this website”, màn hình trắng, hoặc lỗi 500, hãy dùng liên kết recovery mode trong email WordPress để đăng nhập và tắt plugin được nêu tên. Nếu không có liên kết, tắt plugin khi không vào được wp-admin:

1. Mở wp-content/plugins trong File Manager hoặc qua SFTP.
2. Đổi tên thư mục plugin vừa cập nhật, ví dụ plugin-name thành plugin-name-off.
3. Tải lại website. Nếu website chạy, bạn đã tìm ra nguyên nhân.

Nếu bạn không chắc bản cập nhật nào gây ra, hãy làm theo hướng dẫn sửa lỗi nghiêm trọng trên WordPress, trong đó có cách đọc nhật ký gỡ lỗi và tìm đúng tệp.

Bước 5: Quay về phiên bản trước

Khi đã biết plugin hoặc theme nào gây lỗi, hãy trở lại phiên bản từng chạy ổn:

• Plugin từ WordPress.org: cài plugin miễn phí WP Rollback. Plugin này thêm liên kết “Rollback” cho từng plugin và cho bạn chọn phiên bản cũ hơn. Bạn cũng có thể tải phiên bản cũ từ trang plugin trên WordPress.org, mục Advanced View.
• Với WP-CLI: bạn có thể cài đúng một phiên bản:

wp plugin install plugin-name --version=1.2.3 --force

• Plugin và theme trả phí: nhiều nhà cung cấp có phiên bản cũ trong khu vực tài khoản. Nếu không, hãy hỏi bộ phận hỗ trợ của họ.
• Khôi phục bản sao lưu: nếu nhiều thứ hỏng cùng lúc, khôi phục tệp và cơ sở dữ liệu từ ngay trước lúc cập nhật thường là nhanh nhất. Lưu ý bản khôi phục đầy đủ sẽ xóa mọi đơn hàng, bình luận hoặc dữ liệu form nhận được sau thời điểm sao lưu.

Sau khi quay lại, hãy tạm dừng cập nhật tự động cho plugin đó (trên trang Plugins, bấm Disable auto-updates) cho đến khi có bản đã được sửa.

Bước 6: Nếu giao diện hoặc một tính năng bị hỏng

Khi website vẫn tải nhưng hiển thị sai hoặc một tính năng ngừng hoạt động, bản cập nhật thường đổi mã mà các phần khác của website đang phụ thuộc:

• Xóa mọi cache: plugin cache, cache máy chủ, CDN như Cloudflare, và trình duyệt. CSS hoặc JavaScript còn trong cache cũ là lý do phổ biến nhất khiến website trông hỏng sau cập nhật.
• Trình dựng trang: tạo lại tệp CSS trong công cụ của trình dựng, và cập nhật mọi plugin bổ trợ lên phiên bản hỗ trợ bản trình dựng mới.
• Child theme và mã tùy chỉnh: nếu child theme ghi đè tệp template, bản cập nhật theme cha có thể đã đổi các tệp đó. WooCommerce hiện các template ghi đè đã cũ tại WooCommerce → Status.
• Kiểm tra console trình duyệt (F12, rồi Console) để tìm lỗi JavaScript nêu tên tệp gây vấn đề.

Bước 7: Cập nhật an toàn hơn lần sau

• Sao lưu đầy đủ trước khi cập nhật, và giữ một bản ngoài máy chủ.
• Cập nhật từng plugin lớn một, rồi kiểm tra các trang và form quan trọng sau mỗi lần.
• Đọc changelog khi nhảy phiên bản lớn, chẳng hạn từ 4.x lên 5.0.
• Thử các bản cập nhật lớn trên bản staging trước. Nhiều nhà cung cấp hosting có staging một cú nhấp.
• Tránh cập nhật ngay trước giai đoạn đông khách hoặc khi bạn sẽ vắng mặt.

Khi nào nên nhờ chuyên gia

Hãy nhờ giúp nếu quay lại phiên bản cũ không sửa được website, nếu cơ sở dữ liệu đã bị bản cập nhật thay đổi (hay gặp với WooCommerce và plugin thành viên), nếu bạn chạy cửa hàng và đơn hàng đang lỗi, hoặc nếu bạn không có bản sao lưu. Quay lại phiên bản cũ một cách sơ suất có thể khiến dữ liệu lệch với mã.

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

Tôi có nên tắt cập nhật tự động không?

Không nên tắt hoàn toàn. Bản cập nhật bảo mật rất quan trọng, và website lỗi thời rủi ro hơn một lần cập nhật hỏng thỉnh thoảng. Cách dung hòa hợp lý là giữ cập nhật lõi nhỏ tự động và tự cập nhật các plugin lớn sau khi đã sao lưu.

Ở lại phiên bản plugin cũ có an toàn không?

Trong thời gian ngắn thì có. Phiên bản cũ có thể có lỗ hổng bảo mật đã biết, vì vậy hãy cập nhật lại khi nhà phát triển phát hành bản sửa, và xem changelog để tìm ghi chú bảo mật.

Vì sao cập nhật theme làm mất các thay đổi của tôi?

Cập nhật theme thay toàn bộ tệp của theme. Mọi sửa đổi làm trực tiếp trong theme sẽ mất. Hãy đặt mã tùy chỉnh vào child theme hoặc plugin code snippets để mã còn lại sau các lần cập nhật.