Xử lý sự cố thường gặp (Troubleshooting)
Trạng thái
Owner: TBD · Trạng thái: draft · Nguồn chuẩn: flezi.docs
Hướng dẫn khắc phục nhanh các lỗi phổ biến trong quá trình sử dụng.
1. Màn hình Chat bị đứng hoặc báo lỗi "Stream Disconnected"
- Nguyên nhân: Mạng internet không ổn định hoặc proxy ngắt kết nối SSE.
- Cách khắc phục: Nhấn nút Refresh của trình duyệt. Hệ thống tự động Replay lại toàn bộ tin nhắn thông qua Redis Stream cursor (
Last-Event-ID).
2. Lỗi "403 Forbidden" khi nhấn vào một chức năng
- Nguyên nhân: Vai trò tài khoản của bạn trong Workspace hiện tại chưa đủ thẩm quyền.
- Cách khắc phục: Kiểm tra xem bạn có đang ở đúng Workspace hay không, hoặc liên hệ Quản trị viên Workspace để được cấp quyền.
3. Extension Skill Recorder không kết nối được với web app
- Nguyên nhân: Phiên làm việc trên web app đã hết hạn hoặc extension chưa được cấp quyền.
- Cách khắc phục: Mở lại trang
/authorizetrên web app và nhấn nút Authorize Extension.
4. MCP Connector ở trạng thái Needs OAuth hoặc Test Connection timeout
- Needs OAuth: Mở tab Account & OAuth, authorize tài khoản hiện tại rồi Test Connection lại. Connector được chia sẻ không tự chia sẻ OAuth token.
- Test timeout: Kiểm tra endpoint MCP và transport. Tool discovery có giới hạn 30 giây; server không trả danh sách Tools sẽ chuyển sang lỗi thay vì treo run.
- STDIO command not found: Command phải được cài trong môi trường service runtime và có thể tìm thấy qua PATH của service, không chỉ PATH của terminal.
- OAuth quay về UI nhưng không Connected: Chỉ
oauth_result=successxác nhận callback thành công;mcp_connected=1một mình không đủ.