偵錯請求

當 API 請求未如預期運作時，Apidog 提供強大的偵錯工具，協助你快速診斷並解決問題。本指南說明如何使用 Apidog Console 來排查問題，並概述常見問題及其解決方案。

實際請求

傳送請求後，你可以切換到 Actual Request 分頁，以檢視實際傳送到伺服器的完整詳細資訊，包括請求 URL、標頭和主體。

此檢視特別適合用來確認變數、參數和驗證詳細資訊在請求傳送前是否已正確解析。

如果你繼續向下捲動，也可以看到使用各種程式語言傳送此請求的用戶端程式碼，這有助於你在自己的應用程式中實作相同的請求。

在 Console 中偵錯

你可以在請求執行期間隨時使用 console 輸出日誌，協助你定位請求或指令碼中的問題。Apidog 支援以下 console 方法：

變數擷取、資料庫操作和其他自動化流程會自動將其結果輸出到 console，讓你能看見指令碼執行狀況。

常見問題

下表概述你在傳送請求時可能遇到的常見問題及其解決方案：

問題	解決方案
連線能力	如果 Apidog 無法傳送你的請求，可能是連線出現問題。若要檢查，請嘗試在網頁瀏覽器中開啟一個網頁。
防火牆	某些防火牆可能設定為封鎖非來自瀏覽器的連線。在這種情況下，你需要聯絡網路管理員，才能讓 Apidog 正常運作。
Proxy 設定	如果你正在使用 proxy 伺服器傳送請求，請確認你的設定。預設情況下，Apidog 會使用作業系統網路設定中設定的 proxy 設定。Apidog Console 會提供與 proxy 伺服器相關的偵錯詳細資訊。
SSL 憑證	你可能會遇到 HTTPS 連線問題。你可以在 Settings 中點擊設定圖示，然後前往 Settings > General，以停用 SSL 憑證驗證。如果這無法解決問題，你的伺服器可能正在使用用戶端 SSL 連線，可透過點擊設定圖示，然後前往 Settings > Certificates 進行設定。請使用 Apidog Console 確認正確的 SSL 憑證已傳送到伺服器。深入了解如何管理憑證。
用戶端憑證	你的 API 伺服器可能需要用戶端憑證。你可以在 Settings 中點擊設定圖示，然後前往 Settings > Certificates，以新增用戶端憑證。
請求 URL 不正確	如果你在請求中使用變數或路徑參數，請透過檢查 Postman Console 來再次確認最終位址是否正確；它會顯示請求執行時實際傳送到的 URL。未解析的請求變數可能會導致伺服器位址不正確。
通訊協定不正確	請確保你在 URL 中使用正確的通訊協定（http:// 或 https://）。
逾時時間過短	如果 Apidog 中設定了過短的逾時時間，請求可能會在完成前逾時，導致錯誤。若要避免這種情況，請在 Settings 中點擊設定圖示，然後前往 Settings > General，以增加 Request timeout。
無效回應	如果你的伺服器傳送含有編碼錯誤或無效標頭的回應，Apidog 可能難以解析它們。
TLS 版本	Apidog 支援 TLS 1.2 及以上版本，這可能與較舊的瀏覽器或作業系統不相容。
Apidog 錯誤	Apidog 可能正在向你的 API 伺服器傳送不正確的請求。如果你的伺服器日誌可供存取，你可以透過檢查日誌來驗證這一點。如果你懷疑發生此情況，請透過 GitHub issue tracker 聯絡 Apidog 團隊。
未解析的變數	未解析的變數是指在使用該變數的請求可用範圍內尚未定義的變數。
CORS	如果 Apidog Web 應用程式在傳送你的請求時遇到問題，可能是因為跨來源資源共享（CORS）錯誤。請確保你為請求使用適當的 Apidog Agent。你也可以使用 Apidog Client 來避免 CORS 問題。

對於大多數偵錯情境，Actual Request 分頁和 Console 會提供你識別並修正 API 請求問題所需的所有資訊。

實際請求#

在 Console 中偵錯#

常見問題#

實際請求

在 Console 中偵錯

常見問題