Hướng Dẫn Fix Lỗi 500 Internal Server Error Đối Với Mã Nguồn WordPress

Mục lục

1 Giới thiệu
2 Nguyên nhân phổ biến gây lỗi 500 Internal Server Error trên WordPress
3 Hướng dẫn khắc phục lỗi 500 Internal Server Error
4 Những điều cần lưu ý
5 Kết luận

Giới thiệu

Lỗi 500 Internal Server Error là một trong những lỗi phổ biến và gây khó chịu nhất khi vận hành website WordPress. Khi lỗi này xảy ra, website có thể không truy cập được, hiển thị màn hình trắng hoặc thông báo lỗi chung chung, ảnh hưởng trực tiếp đến trải nghiệm người dùng cũng như hoạt động kinh doanh.

Trong quá trình vận hành website WordPress trên Hosting hoặc VPS, lỗi 500 thường xuất phát từ cấu hình máy chủ, mã nguồn hoặc plugin/theme không tương thích.

Tài liệu này được Zhost xây dựng nhằm giúp khách hàng:

Hiểu rõ nguyên nhân gây lỗi 500 Internal Server Error.
Tự kiểm tra và khắc phục các lỗi phổ biến.
Biết khi nào cần liên hệ đội ngũ kỹ thuật để được hỗ trợ kịp thời.

Nguyên nhân phổ biến gây lỗi 500 Internal Server Error trên WordPress

Một số nguyên nhân thường gặp bao gồm:

File .htaccess bị lỗi hoặc cấu hình sai.
Plugin hoặc Theme WordPress xung đột.
Phiên bản PHP không tương thích với mã nguồn.
Phân quyền file/thư mục (permission) không đúng.
Website vượt quá giới hạn bộ nhớ PHP.
Lỗi cấu hình máy chủ (ModSecurity, Firewall, Web Server).
File hệ thống WordPress bị lỗi hoặc thiếu.

Việc xác định đúng nguyên nhân sẽ giúp quá trình xử lý nhanh và hiệu quả hơn.

Hướng dẫn khắc phục lỗi 500 Internal Server Error

Cách 1: Kiểm tra và reset file .htaccess.

File .htaccess bị lỗi là nguyên nhân rất phổ biến gây ra lỗi 500.

Cách thực hiện:

Truy cập website qua FTP hoặc File Manager trên Hosting.
Vào thư mục gốc của mã nguồn.
Đổi tên file .htaccess thành .htaccess_old.
Truy cập lại website để kiểm tra.
Nếu website hoạt động bình thường, vào Dashboard → Settings → Permalinks và nhấn Save Changes để WordPress tạo lại file .htaccess.

Cách 2: Tắt toàn bộ plugin để kiểm tra xung đột.

Plugin không tương thích hoặc lỗi cập nhật có thể gây lỗi 500.

Cách thực hiện:

Truy cập thư mục wp-content.
Đổi tên thư mục plugins thành plugins_old.
Kiểm tra lại website.
Nếu website hoạt động, đổi tên thư mục về plugins và kích hoạt từng plugin để xác định plugin gây lỗi.

Cách 3: Đổi sang theme mặc định của WordPress.

Theme lỗi hoặc không tương thích với PHP cũng có thể gây ra lỗi 500.

Cách thực hiện:

Vào thư mục wp-content/themes.
Đổi tên thư mục theme đang sử dụng.
WordPress sẽ tự động chuyển sang theme mặc định (Twenty Twenty-One, Twenty Twenty-Two…).

Cách 4: Kiểm tra và chỉnh quyền file & thư mục.

Phân quyền không đúng có thể khiến web server không thực thi được mã nguồn.

Phân quyền khuyến nghị:

Thư mục: 755.
File: 644.

Không nên đặt quyền 777 vì có thể gây mất an toàn bảo mật.

Cách 5: Kiểm tra và thay đổi phiên bản PHP.

Một số plugin hoặc theme chỉ tương thích với phiên bản PHP nhất định.

Khuyến nghị:

PHP 8.0 – 8.2 (tùy mã nguồn)

Bạn có thể thay đổi phiên bản PHP trong:

cPanel → MultiPHP Manager / Select PHP Version.
DirectAdmin → Select PHP Version.

Nếu bạn chưa biết cách thay đổi phiên bản PHP cho 2 trình quản trị trên, hãy tham khảo tài liệu hướng dẫn dưới đây:

Cách 6: Kiểm tra log lỗi (error_log).

Log lỗi sẽ cung cấp thông tin chính xác nguyên nhân gây lỗi 500.

Vị trí thường gặp:

error_log trong thư mục website.
Log PHP / Apache / Nginx trên máy chủ.

Dựa vào log, bạn có thể xác định plugin, file hoặc cấu hình gây lỗi.

Những điều cần lưu ý

Luôn backup dữ liệu trước khi chỉnh sửa mã nguồn.
Không chỉnh sửa file hệ thống nếu không nắm rõ chức năng.
Tránh cài đặt quá nhiều plugin không cần thiết.
Thường xuyên cập nhật WordPress, plugin và theme.
Theo dõi tình trạng website định kỳ để phát hiện lỗi sớm.

Kết luận

Lỗi 500 Internal Server Error trên WordPress tuy phổ biến nhưng hoàn toàn có thể xử lý nếu xác định đúng nguyên nhân. Việc kiểm tra từng bước sẽ giúp website nhanh chóng hoạt động trở lại mà không gây ảnh hưởng lớn đến dữ liệu. Chúc các bạn thành công!