トラブルシューティング(FAQ)
「症状 → 原因 → 対処」で整理しています。接続失敗、認証失敗、文字化け、変数未解決が4大カテゴリです。
接続・送信の失敗
| 症状 | 考えられる原因 | 対処 |
|---|---|---|
| 「ベースアドレスがない」と表示される | グループに環境がバインドされていない、ま たは環境にそのプロトコルのPre-URLがない | 環境をバインドし、プロトコルのPre-URLを追加 |
| WS/gRPC/MQTTが接続できない | Pre-URLのschemeが誤り(プロトコルはschemeで分類される) | wsは ws/wss、grpcは grpc/grpcs、mqttは mqtt/mqtts を使用 |
| TCP/UDPが接続できない | hostとportの取り違え | hostがアドレス、portは別フィールド |
| TLSエラー | 暗号化schemeなのに証明書未設定 | 必要に応じてクライアント証明書をインポート、またはTLS検証をオフに |
| 長時間接続が突然切れる | アイドル時に自動回収された | 使用前に再接続。連続デバッグ時は古いセッションを速やかに閉じる(クォータには上限あり) |
認証 (401 / 403)
| 症状 | 原因 | 対処 |
|---|---|---|
| トークンがあるのに401 | 送信前スクリプトが実行されていない(スクリプト実行が無効) | 「スクリプトを実行」が有効か確認 |
{{authToken}} が文字列のまま置換されない | {{}} は実行時に保存されたトークンを読めない | sdk.env.get 付きの送信前スクリプトでヘッダーに注入(recipes、シナリオ1 参照) |
| ログイン後の次のリクエストでトークンが取れない | 2つのリクエストが別グループ / 別環境にある | 同じ環境にバインドされた同じグループに置く(実行時変数は環境単位のスコープ) |
文字化け / エンコーディング
| 症状 | 原因 | 対処 |
|---|---|---|
| レスポンスの中国語が文字化け | サーバーが非UTF-8(例:GBK)を返す | 対応するcharsetでデコード。/charset/gbk で再現 |
復号が Error: ... 文字列を返す | ciphertextが無効/空、または鍵/ivが暗号化時と違う($cryptoの失敗はエラー文字列を返すだけで、例外や中断はしない) | 暗号化/復号で鍵とivを同一に。返り値が Error: で始まるか確認(中国語plaintextの往復は問題なし、検証済み) |
スクリプトが Script aborted request を報告 | スクリプト内の未捕捉JS例外(多いのは headers.set への非ASCIIヘッダー値、undefined へのプロパティアクセス) | リスクのある呼び出しは try/catch で包む。UTF-8の内容はbody/query paramsへ、ヘッダー値はASCIIのままに |
| スクリプト内のbase64結果がおかしい | Uint8Array/bytes を $codec/sdk.utils に渡した(エンコード前に String() 化で "97,98,99" になる) | 常に文字列を渡す。$codec.base64Encode/Decode と sdk.utils.base64Encode/Decode はどちらもUTF-8対応のstring↔string — どちらか一方に統一 |
スクリプトが効かない
| 症状 | 原因 | 対処 |
|---|---|---|
| 送信前スクリプトでbodyを変えたのにワイヤーに反映されない | 「代入」による書き換えになっていない | request.body = new string(代入がbody全体を置き換える) |
| レスポンス後の書き換えが見えない | 書き換え方 | response.body = new string。UI/結果ビューには書き換え後の内容が表示される |
| スクリプトが「エントリーポイントなし、スキップ」と報告される | 関数名が違う | onRequest / onResponse という名前である必要がある |
| スクリプト同士が互いの値を読めない | 共有の仕組みを知らない | 同じチェーンのスクリプトは**globalThis を共有**します — globalThis.xxx で値を受け渡す |
| スクリプトでAES「暗号化失敗」 | 引数の形が違う | $crypto.encryptAES は位置指定の文字列を取り、{text,key,iv} オブジェクトではない |
スクリプトが require: 未找到库 [...] で失敗 | ライブラリキーが間違い、またはユーザーのスクリプトライブラリがリネーム/削除された | ライブラリマネージャーからrequire文をコピー(identifier形はリネームに強い)。組み込みキーは @libs/base64 / @libs/hex。コメント内の require は無視され、バンドルもされない |
変数解決の早見表
{{name}}:解決するのは環境の設定変数 / 送信時変数だけです。スクリプトが実行時に保存した値は読めません。- スクリプト内での変数読み取り:3層すべて読めます — リクエスト間のトークン受け渡しに使います。
- 抽出した値を
{{}}からも使えるようにするには:「抽出結果を環境へ書き戻す」設定を有効にします。
詳細:concepts、変数システム。
それでも解決しないときは
- まず
/echo(HTTP)や/ws/echo(WS)で「最小の動くケース」を回し、そこへ認証 / スクリプトを1段ずつ足します。 - 1段ずつ切り分け:リクエストは出ているか(接続できない → Pre-URL/host/portを確認)→ スクリプトは実行されているか(スクリプト実行は有効か)→ 変数は解決されているか(どの層か)?
- スクリプト関連のエラーはスクリプトAPIリファレンスと突き合わせ られます。