Xử lý sự cố (FAQ)
Sắp xếp theo mẫu "triệu chứng → nguyên nhân → cách xử lý". Lỗi kết nối, lỗi xác thực, văn bản lỗi font và biến không phân giải được là bốn nhóm lớn.
Lỗi kết nối / gửi
| Triệu chứng | Nguyên nhân có thể | Cách xử lý |
|---|---|---|
| Báo "No base address" | Nhóm chưa gắn môi trường, hoặc môi trường thiếu Pre-URL của giao thức đó | Gắn môi trường, thêm Pre-URL của giao thức |
| WS/gRPC/MQTT không kết nối được | Scheme Pre-URL sai (giao thức được phân loại theo scheme) | ws dùng ws/wss, grpc dùng grpc/grpcs, mqtt dùng mqtt/mqtts |
| TCP/UDP không kết nối được | Host và port bị tráo | Host giữ địa chỉ, port để riêng |
| Lỗi TLS | Dùng scheme mã hóa nhưng chưa cấu hình chứng chỉ | Nhập chứng chỉ khách, hoặc tắt xác minh TLS nếu cần |
| Kết nối dài tự nhiên mất | Tự bị thu hồi khi rảnh | Kết nối lại trước khi dùng; đóng các phiên cũ ngay khi gỡ lỗi hàng loạt (hạn mức có giới hạn) |
Xác thực (401 / 403)
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
| 401 dù có token | Script trước khi gửi chưa chạy (thực thi script bị tắt) | Xác nhận "thực thi script" đang bật |
{{authToken}} vẫn là chữ nguyên bản (không thay thế) | {{}} không đọc được token lưu ở thời gian chạy | Dùng script trước khi gửi với sdk.env.get để chèn header (xem recipes, kịch bản 1) |
| Yêu cầu tiếp theo không lấy được token sau đăng nhập | Hai yêu cầu ở nhóm / môi trường khác nhau | Đặt c ả hai vào cùng nhóm gắn cùng môi trường (biến thời gian chạy có phạm vi theo môi trường) |
Văn bản lỗi font / mã hóa
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
| Chữ Trung Quốc lỗi font trong phản hồi | Máy chủ trả về không phải UTF-8 (ví dụ GBK) | Giải mã bằng charset khớp; tái hiện qua /charset/gbk |
Giải mã trả về chuỗi Error: ... | Ciphertext không hợp lệ/rỗng, hoặc key/iv khác lúc mã hóa (lỗi $crypto chỉ trả về chuỗi lỗi, không bao giờ ném/ngắt) | Giữ key và iv mã hóa/giải mã giống nhau; kiểm tra chuỗi trả về có bắt đầu bằng Error: không (văn bản Trung Quốc nguyên bản round-trip tốt, đã xác minh) |
Script báo Script aborted request | Ngoại lệ JS không được bắt trong script (thường gặp: giá trị header không ASCII trong headers.set, hoặc truy cập thuộc tính trên undefined) | Bọc các lệnh rủi ro trong try/catch; đặt nội dung UTF-8 vào body/query params và giữ giá trị header ASCII |
| Kết quả base64 kỳ lạ trong script | Truyền Uint8Array/byte vào $codec/sdk.utils (bị String() hóa thành "97,98,99" trước khi mã hóa) | Luôn truyền chuỗi; cả $codec.base64Encode/Decode lẫn sdk.utils.base64Encode/Decode đều nhận biết UTF-8 chuỗi↔chuỗi — chọn một |
Script không có hiệu lực
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
| Script trước khi gửi đã đổi body nhưng trên đường truyền không thấy | Không viết lại bằng "gán" | request.body = new string (phép gán thay toàn bộ body) |
| Viết lại sau phản hồi không nhìn thấy | Viết thế nào | response.body = new string; giao diện UI/kết quả hiển thị nội dung mới sau khi viết lại |
| Script bị báo "không có điểm vào, bỏ qua" | Tên hàm sai | Phải đặt tên đúng onRequest / onResponse |
| Các script không đọc được giá trị của nhau | Chưa hiểu cơ chế chia sẻ | Script trong cùng chuỗi chia sẻ globalThis — truyền giá trị qua globalThis.xxx |
| AES "mã hóa thất bại" trong script | Sai dạng tham số | $crypto.encryptAES nhận chuỗi vị trí, không phải đối tượng {text,key,iv} |
Script thất bại với require: 未找到库 [...] | Sai khóa thư viện, hoặc thư viện script người dùng bị đổi tên/xóa | Sao chép câu lệnh require từ trình quản lý thư viện (dạng định danh sống sót qua việc đổi tên); khóa tích hợp là @libs/base64 / @libs/hex; require trong chú thích bị bỏ qua và không bao giờ được đóng gói |
Cẩm nang phân giải biến
{{name}}: chỉ phân giải biến cấu hình môi trường / biến theo từng lần gửi; không đọc được giá trị script lưu ở thời gian chạy.- Đọc biến bên trong script: cả ba tầng đều đọc được — dùng cho việc chuyển token giữa các yêu cầu.
- Để giá trị trích xuất cũng dùng được với
{{}}: bật cài đặt "ghi kết quả trích xuất ngược về môi trường".
Chi tiết: concepts, hệ thống biến.
Vẫn bị kẹt?
- Chạy trước "ví dụ tối giản hoạt động được" với
/echo(HTTP) hoặc/ws/echo(WS), sau đó thêm auth/script từng bước. - Gỡ lỗi từng bước một: yêu cầu có ra đi được không (không kết nối → kiểm tra Pre-URL/host/port) → script có chạy không (thực thi script có bật không) → biến có phân giải được không (tầng nào)?
- Lỗi liên quan script có thể đối chiếu với Tài liệu tham khảo API Script.