504 Gateway Timeout WordPress xảy ra khi Nginx, Apache, Cloudflare hoặc proxy chờ backend quá lâu nhưng không nhận được phản hồi. Trên VPS, bạn cần kiểm tra PHP-FPM, database, plugin nặng, timeout cấu hình và tải hệ thống trước khi tăng timeout hoặc nâng cấp VPS.
Lỗi 504 Gateway Timeout WordPress là gì?
504 là lỗi timeout ở tầng gateway. Nói đơn giản, request đã tới gateway như Nginx hoặc Cloudflare, nhưng backend xử lý WordPress phản hồi quá chậm. Người dùng thường thấy trang quay rất lâu rồi mới báo lỗi.
Với WordPress, lỗi này hay xảy ra ở wp-admin, trang import, checkout, trang có query nặng hoặc khi plugin backup/cache chạy nền. Nó khác 502 ở chỗ backend không hẳn trả lời sai; nó chỉ không trả lời kịp thời.
504 khác gì 502 Bad Gateway?
502 nghiêng về backend lỗi hoặc kết nối bị đứt, còn 504 là chờ quá lâu. Cách debug vì vậy cũng khác: 504 cần nhìn request chậm, timeout và database nhiều hơn.
Dấu hiệu nhận biết lỗi 504 trên WordPress
Trang public chậm bất thường, wp-admin đứng, REST API timeout, đơn hàng WooCommerce xử lý lâu hoặc import/export không hoàn tất.
Nguyên nhân gây lỗi 504 Gateway Timeout WordPress
Các bài đối thủ thường nhắc reload trình duyệt, DNS hoặc cache. Những cách đó có thể giúp loại trừ lỗi tạm thời, nhưng với VPS bạn cần đi sâu hơn: PHP xử lý lâu, database chậm, timeout thấp, VPS quá tải hoặc CDN không chờ đủ.
Nếu lỗi chỉ xảy ra ở một thao tác cụ thể, đừng vội tăng timeout toàn site. Hãy tìm tác vụ gây chậm và tối ưu nó trước.
PHP xử lý quá lâu do plugin hoặc theme nặng
Plugin page builder, WooCommerce, backup, security scan và import dữ liệu là nhóm dễ gây request dài.
Database MySQL/MariaDB phản hồi chậm
Query chậm, autoload quá lớn hoặc bảng phình to có thể làm PHP chờ database tới timeout.
Nginx, Apache hoặc PHP-FPM timeout quá thấp
Các giá trị như fastcgi_read_timeout, proxy_read_timeout, max_execution_time cần phù hợp với tác vụ thật.
VPS thiếu CPU/RAM hoặc disk I/O
Tài nguyên cạn làm request xếp hàng, từ đó sinh timeout.
CDN, Cloudflare hoặc firewall gây timeout
Nếu có proxy phía trước, hãy kiểm tra cả origin và lớp CDN.
Cách kiểm tra lỗi 504 trên WordPress VPS
Tôi thường bắt đầu bằng log và tài nguyên. Nếu log Nginx ghi upstream timed out, hãy kiểm tra PHP-FPM và request đang chạy. Nếu CPU/RAM cao, tìm process. Nếu database chậm, xem MySQL processlist hoặc slow query log.
sudo tail -n 100 /var/log/nginx/error.log
sudo journalctl -u php8.2-fpm -n 100 --no-pager
free -h && uptime && df -h
mysqladmin processlistKiểm tra error log Nginx/Apache
Log cho biết request nào timeout và upstream nào bị chờ quá lâu.
Kiểm tra PHP-FPM slow log và PHP error log
Slow log rất hữu ích để biết file/plugin nào xử lý lâu.
Kiểm tra tải CPU/RAM/I/O
Nếu load average cao kéo dài, lỗi 504 có thể là hậu quả của nghẽn tài nguyên.
Kiểm tra truy vấn database chậm
Database chậm làm toàn bộ WordPress chậm, đặc biệt ở wp-admin và WooCommerce.
Cách sửa lỗi 504 Gateway Timeout WordPress
Bạn có thể tăng timeout để website vượt qua một tác vụ dài, nhưng đó chỉ là biện pháp hỗ trợ. Sửa gốc thường nằm ở plugin, database, cache hoặc tài nguyên VPS.
sudo systemctl reload nginx
# ví dụ Nginx:
fastcgi_read_timeout 120s;
# ví dụ PHP:
max_execution_time = 120Tắt plugin/theme nghi ngờ bằng SSH hoặc WP-CLI
Nếu lỗi xuất hiện sau update plugin, hãy cô lập plugin đó trước.
Tăng max_execution_time và request_terminate_timeout khi cần
Chỉ tăng vừa đủ cho tác vụ hợp lý; đừng biến mọi request thành request chạy vô hạn.
Tăng proxy_read_timeout hoặc fastcgi_read_timeout trên Nginx
Hữu ích khi backend cần thêm thời gian, nhưng không thay thế tối ưu backend.
Tối ưu database và cache
Dọn transient, autoload quá lớn, bật page cache/object cache đúng cách.
Xử lý riêng import, backup hoặc WooCommerce
Các tác vụ nặng nên chạy ngoài giờ cao điểm và có batch nhỏ hơn.
Cách phòng tránh lỗi 504 tái diễn
Một site ít bị 504 thường có cache tốt, plugin gọn, database vừa phải, PHP-FPM đủ worker và VPS còn dư tài nguyên. Bạn không cần làm phức tạp ngay từ đầu, nhưng nên có thói quen đo trước khi sửa.
Nếu 504 chỉ xảy ra vào giờ backup, hãy đổi lịch backup. Nếu xảy ra khi traffic tăng, kiểm tra cache và tài nguyên. Nếu xảy ra ở checkout, ưu tiên kiểm tra plugin thanh toán, email SMTP và WooCommerce hooks.
Dùng cache, object cache và cron đúng cách
Cache giảm số request chạm PHP/database, cron thật giúp tác vụ nền ổn định hơn.
Giám sát tài nguyên VPS
Biết lúc nào CPU/RAM/disk tăng giúp tìm nguyên nhân nhanh hơn.
Chọn cấu hình VPS phù hợp WordPress
WooCommerce hoặc site nhiều plugin cần tài nguyên rộng hơn blog nhỏ.
Câu hỏi thường gặp về lỗi 504 gateway timeout wordpress
lỗi 504 gateway timeout wordpress có ảnh hưởng SEO không?
Có. Nếu lỗi kéo dài làm Googlebot hoặc người dùng không truy cập được nội dung, tín hiệu crawl và trải nghiệm đều bị ảnh hưởng. Với lỗi server, tôi thường ưu tiên khôi phục HTTP 200 ổn định trước, sau đó mới tối ưu chi tiết.
Có nên restart toàn bộ VPS khi gặp lỗi 504 gateway timeout wordpress không?
Không nên xem reboot là phản xạ đầu tiên. Bạn nên đọc log, kiểm tra service liên quan và restart đúng thành phần như Nginx, PHP-FPM, database hoặc firewall. Reboot có thể che mất dấu vết lỗi và gây downtime dài hơn.
Người mới có tự xử lý được không?
Có thể xử lý các bước kiểm tra cơ bản nếu làm chậm, đọc kỹ lệnh và giữ backup. Nhưng với website có đơn hàng, dữ liệu khách hàng hoặc downtime đang gây thiệt hại, nên nhờ kỹ thuật hỗ trợ để tránh sửa sai.
Sau khi sửa xong cần theo dõi bao lâu?
Ít nhất vài giờ sau khi sửa nên theo dõi log, CPU, RAM, disk và hành vi người dùng. Nếu lỗi từng xảy ra khi traffic cao, hãy kiểm tra thêm vào khung giờ cao điểm.
Khi nào nên nâng cấp VPS?
Chỉ nên nâng cấp khi bạn đã xác định nghẽn tài nguyên là nguyên nhân thật. Nếu lỗi đến từ plugin, cấu hình SSH, firewall, database hoặc log đầy, nâng VPS có thể không giải quyết tận gốc.
