Cloudflare AI Gateway lỗi 401: đội làm chatbot cần xử lý gì?

Khách vẫn đăng nhập được nhưng chatbot không trả lời. Máy chủ cũng không quá tải. Trong tình huống này, đội phát triển nên kiểm tra khóa truy cập dịch vụ AI trước khi yêu cầu khách đăng nhập lại hoặc nâng cấu hình máy.

Ngày 06/10/2026, Cloudflare thông báo thay đổi cách báo lỗi khi nhà cung cấp AI từ chối thông tin xác thực. Bài này dành cho đội phát triển chatbot đang gọi dịch vụ AI qua Cloudflare AI Gateway.

Cloudflare thay đổi điều gì?

AI Gateway là dịch vụ trung gian giữa ứng dụng và nhà cung cấp AI. Ứng dụng gửi yêu cầu qua một giao diện lập trình, gọi là API. Khóa truy cập, thường gọi là API key, giúp nhà cung cấp kiểm tra ứng dụng có quyền sử dụng dịch vụ hay không.

Với yêu cầu gửi tới POST /ai/run, lỗi thông tin xác thực bị nhà cung cấp từ chối nay được trả về dưới dạng HTTP 401, mã lỗi 2009. HTTP là giao thức trao đổi dữ liệu trên web; mã trạng thái cho biết yêu cầu thành công hay thất bại. Riêng Unified Billing, hình thức thanh toán dịch vụ AI qua Cloudflare, trường hợp này trả về HTTP 503.

Đối với Google Vertex, Cloudflare cho biết lỗi này trước đây trả 500 và có gọi lại nhà cung cấp. Sau cập nhật, yêu cầu thất bại với 401/2009 và không được gọi lại ở phía nhà cung cấp. Phạm vi thông báo là đường dẫn API nêu trên; đội phát triển cần kiểm tra cách tích hợp của mình trước khi áp dụng cho đường dẫn khác.

Vì sao không nên bắt khách đăng nhập lại?

Một chatbot có thể dùng hai lớp xác thực: tài khoản để khách vào ứng dụng và khóa để máy chủ gọi dịch vụ AI. Backend, phần mềm chạy phía máy chủ, cần phân biệt hai lớp này khi xử lý lỗi.

Ví dụ, khách đã đăng nhập hợp lệ nhưng khóa AI của ứng dụng bị thu hồi. Nếu phần giao diện cứ thấy mã 401 là đưa khách về trang đăng nhập, khách sẽ mắc trong vòng lặp: đăng nhập thành công rồi lại bị yêu cầu đăng nhập. Đăng nhập lại không sửa được khóa mà máy chủ đang sử dụng.

Đội phát triển nên trả thông báo dễ hiểu như “Dịch vụ AI tạm thời chưa xử lý được yêu cầu. Vui lòng thử lại sau”, kèm mã tra cứu cho bộ phận hỗ trợ. Chi tiết khóa và phản hồi kỹ thuật cần được kiểm tra ở phía máy chủ.

Gọi lại yêu cầu cần có điểm dừng

Retry nghĩa là gửi lại một yêu cầu đã thất bại. Cách này có thể hữu ích khi kết nối bị gián đoạn, nhưng một khóa bị từ chối thường cần được sửa trước. Gửi lại liên tục với cùng khóa sẽ không giải quyết nguyên nhân.

Với lỗi xác thực đã xác định, nên dừng việc thử lại tự động và báo cho người quản lý cấu hình. Với lỗi tạm thời, đặt giới hạn số lần thử và tổng thời gian chờ. Kiểm tra cả thư viện gọi AI lẫn tác vụ chạy nền: mỗi nơi tự thử lại vài lần có thể khiến tổng số lần gọi tăng ngoài dự kiến.

Nếu dùng Unified Billing và nhận 503, hãy đọc thêm chi tiết phản hồi thay vì chỉ dựa vào mã trạng thái để kết luận máy chủ thiếu tài nguyên. Khi cân nhắc chuyển sang một dịch vụ AI dự phòng, cần kiểm tra quyền gửi dữ liệu khách hàng sang dịch vụ đó.

Năm việc nên kiểm tra trước khi cập nhật ứng dụng

1. Liệt kê những chỗ đang xử lý lỗi 401 và 503; xác định lỗi đến từ tài khoản khách hay từ dịch vụ AI.
2. Dùng khóa thử nghiệm bị từ chối trong môi trường thử nghiệm, tách biệt với hệ thống đang phục vụ khách hàng.
3. Kiểm tra giao diện không tự đăng xuất khách khi lỗi nằm ở khóa AI.
4. Đếm số lần gửi yêu cầu và thời gian chờ để phát hiện việc gọi lại không có điểm dừng.
5. Kiểm tra nhật ký hoạt động (log), che khóa truy cập và nội dung khách hàng trước khi chia sẻ cho người hỗ trợ.

Nếu ứng dụng gửi câu trả lời từng phần khi AI đang tạo nội dung, hãy kiểm tra thêm tình huống lỗi sau khi khách đã nhận được một phần câu trả lời. Bộ phận hỗ trợ cần biết yêu cầu đã hoàn tất hay mới dừng giữa chừng.

Đội phát triển chatbot nên làm gì tiếp theo?

Trước mắt, hãy rà soát luồng xử lý lỗi theo danh sách trên. Có thể dùng hướng dẫn giám sát máy chủ để bổ sung cảnh báo, đồng thời theo dõi tỷ lệ yêu cầu AI thành công và thời gian trả lời.

Nếu bạn đang chọn hạ tầng cho chatbot, hãy đọc so sánh thuê GPU và dùng API AI. Dùng API ngoài và tự chạy mô hình có cách vận hành khác nhau; lỗi khóa truy cập cần được xử lý trước khi quyết định nâng cấp hạ tầng.

Bạn phụ trách triển khai chatbot cho doanh nghiệp? Hãy gửi số người dùng đồng thời dự kiến, mô hình AI đang dùng và nhu cầu chạy ứng dụng hay chạy cả mô hình tới hotro@thuemaychu.vn để trao đổi phương án hạ tầng. Tham khảo Cloud VPS cho phần ứng dụng hoặc GPU Server khi cần tự chạy mô hình. Các thông tin này giúp cuộc trao đổi tập trung vào nhu cầu thực tế; không gửi kèm khóa truy cập hay dữ liệu khách hàng.