メインコンテンツまでスキップ

トラブルシューティング(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リファレンスと突き合わせられます。