Chuyển tới nội dung chính

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ứngNguyê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 đượcScheme 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 đượcHost và port bị tráoHost giữ địa chỉ, port để riêng
Lỗi TLSDù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ấtTự bị thu hồi khi rảnhKế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ứngNguyên nhânCách xử lý
401 dù có tokenScript 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ạyDù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ậpHai 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ứngNguyên nhânCách xử lý
Chữ Trung Quốc lỗi font trong phản hồiMá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 requestNgoạ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 scriptTruyề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ứngNguyên nhânCách xử lý
Script trước khi gửi đã đổi body nhưng trên đường truyền không thấyKhô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ấyViết thế nàoresponse.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 saiPhải đặt tên đúng onRequest / onResponse
Các script không đọc được giá trị của nhauChư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 scriptSai 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óaSao 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.