Các vấn đề thường gặp
Các vấn đề thường gặpLỗi 'Operation timed out'

Lỗi 'Operation timed out'

Nếu API của nhà cung cấp AI mất quá nhiều thời gian để phản hồi, yêu cầu sẽ bị hủy bởi HTTP client của plugin và quá trình dịch sẽ thất bại với lỗi tương tự như sau:

2026-05-20T03:11:48+00:00 Error [Query "translate-customposts"] Execution with errors: 🔴 Translation to es_AR failed - The API for provider 'ChatGPT' returned error: cURL error 28: Operation timed out after 60000 milliseconds with 0 bytes received (see https://curl.haxx.se/libcurl/c/libcurl-errors.html) for https://api.openai.com/v1/chat/completions

Phần quan trọng là cURL error 28: Operation timed out after N milliseconds. Điều này có nghĩa là yêu cầu đã đạt đến giới hạn Translation Timeout được cấu hình trong plugin trước khi API hoàn thành phản hồi.

Tăng Translation Timeout

Vào trang Cài đặt, tại mục Plugin Configuration > Translation Timeout, và tăng giá trị lên.

Thiết lập tùy chọn Translation Timeout
Thiết lập tùy chọn Translation Timeout

Hãy giữ giá trị dưới mức max_execution_time của máy chủ (được đặt trong php.ini, hoặc qua bảng điều khiển hosting của bạn) để một quá trình dịch bị treo vẫn thất bại một cách có kiểm soát với lỗi ghi trong log — thay vì kích hoạt timeout chung của máy chủ (HTTP 502 / 504, hoặc trang trắng "Maximum execution time of N seconds exceeded").

Nếu các bản dịch của bạn thường xuyên bị timeout, hãy tăng cả hai giá trị: Translation Timeout max_execution_time của máy chủ cùng một lúc.

Giảm payload gửi trong mỗi yêu cầu

Một cách khắc phục bổ sung là gửi các yêu cầu ngắn hơn, để mỗi yêu cầu được xử lý nhanh hơn và ít có khả năng chạm đến giới hạn timeout hơn.

Vào Settings > Service Configuration > [AI service], và giảm tùy chọn Max request payload length xuống số ký tự phù hợp.

Ví dụ, nếu đang đặt là 4000 mà vẫn thất bại, hãy thử 2000.

Thiết lập tùy chọn 'Max request payload length'
Thiết lập tùy chọn 'Max request payload length'

Khi payload được giảm, quá trình dịch sẽ được chia thành nhiều yêu cầu nhỏ hơn, mỗi yêu cầu sẽ được xử lý nhanh hơn.

Xem thêm Tránh timeout trên máy chủ PHP.