如果您的 API 請求未按預(yù)期運行，可能有多種原因。要找出問題所在，您可以使用 Postman 控制臺對您的請求進(jìn)行故障排除。本指南還列出了常見問題及其原因。

本指南專門討論對 API 請求進(jìn)行故障排除。要解決 Postman 應(yīng)用程序的問題，請參閱解決應(yīng)用程序問題。要解決 Postman 監(jiān)視器的問題，請參閱監(jiān)視器故障排除。

在控制臺中調(diào)試

Postman 發(fā)送的每個請求都記錄在控制臺中，因此您可以查看發(fā)送請求時發(fā)生的詳細(xì)信息。這意味著當(dāng) API 未按預(yù)期運行時，您可以使用 Postman 控制臺幫助調(diào)試您的請求。在工作時保持控制臺打開將增加調(diào)試時網(wǎng)絡(luò)調(diào)用和日志消息的可見性。

Postman 控制臺記錄以下信息：

• 發(fā)送的主要請求，包括所有底層請求標(biāo)頭、變量值和重定向
• 用于請求的代理配置和證書
• 網(wǎng)絡(luò)信息，例如 IP 地址、密碼和使用的協(xié)議
• 來自測試或預(yù)請求腳本的日志語句和異步請求
• 在 Postman 處理之前由服務(wù)器發(fā)送的原始響應(yīng)

監(jiān)控結(jié)果記錄到單獨的控制臺。有關(guān)如何查看監(jiān)視器運行日志的更多信息，請參閱查看監(jiān)視器結(jié)果。

打開控制臺

通過在 Postman 頁腳中選擇  控制臺來打開控制臺。在 Postman 桌面應(yīng)用程序中，您還可以選擇?+Option+C或Ctrl+Alt+C。

從控制臺查看請求錯誤

如果 Postman 無法發(fā)送您的請求，或者如果它沒有收到您發(fā)送請求的 API 的響應(yīng)，您將收到一條錯誤消息。此消息將包含問題概述和控制臺鏈接，您可以在其中訪問有關(guān)請求的詳細(xì)信息。

選擇“在控制臺中查看”以檢查控制臺中的請求詳細(xì)信息，并了解有關(guān)出錯原因的更多信息。

控制臺導(dǎo)航

控制臺顯示網(wǎng)絡(luò)信息以及每個請求的請求和響應(yīng)標(biāo)頭和正文，以及來自您的腳本的任何控制臺輸出消息。

在所有日志下按日志消息類型過濾。選擇更多操作圖標(biāo)  以打開或關(guān)閉時間戳和網(wǎng)絡(luò)信息。

默認(rèn)情況下，控制臺將記錄最后 5000 條消息和 24 小時。選擇清除以清空列表。

使用日志語句

在測試腳本的適當(dāng)位置使用日志語句可以幫助您調(diào)試請求。Postman 接受以下日志語句：

• console.log()
• console.info()
• console.warn()
• console.error()
• console.clear()

常見問題

如果您在發(fā)送請求時遇到的問題未在此處列出，請參閱獲取幫助以獲取有關(guān)如何聯(lián)系 Postman 支持的信息。

問題	解決問題
連通性	如果 Postman 無法發(fā)送您的請求，您可能遇到了連接問題。通過嘗試在網(wǎng)絡(luò)瀏覽器中打開一個頁面來檢查您的連接。
防火墻	一些防火墻可能被配置為阻止非瀏覽器連接。如果發(fā)生這種情況，您需要聯(lián)系您的網(wǎng)絡(luò)管理員以使 Postman 工作。
代理配置	如果您使用代理服務(wù)器發(fā)出請求，請檢查您的配置。默認(rèn)情況下，Postman 使用操作系統(tǒng)網(wǎng)絡(luò)設(shè)置中配置的代理設(shè)置。Postman 控制臺將提供有關(guān)代理服務(wù)器的調(diào)試信息。
SSL證書	您可能會在使用 HTTPS 連接時遇到問題。您可以在設(shè)置中關(guān)閉 SSL 證書驗證，方法是選擇設(shè)置圖標(biāo)  > 設(shè)置 > 常規(guī)。如果這沒有幫助，您的服務(wù)器可能正在使用客戶端 SSL 連接，您可以通過選擇設(shè)置圖標(biāo) > 設(shè)置  >證書來配置該連接。使用Postman 控制臺確保將正確的 SSL 證書發(fā)送到服務(wù)器。
客戶證書	您的 API 服務(wù)器可能需要客戶端證書。您可以通過選擇設(shè)置圖標(biāo) > 設(shè)置 > 證書在設(shè)置中添加客戶端證書。
錯誤的請求 URL	如果您在請求中使用變量或路徑參數(shù)，請通過打開控制臺確保最終地址的結(jié)構(gòu)正確，它將顯示您的請求在執(zhí)行時發(fā)送到的 URL。未解析的請求變量可能導(dǎo)致無效的服務(wù)器地址。
協(xié)議不正確	檢查您是否在 URL 中使用https://而不是http://（或相反）。
短超時	如果您在 Postman 中配置了一個較短的超時時間，請求可能會在完成之前超時，從而導(dǎo)致錯誤。要避免此問題，請通過選擇設(shè)置圖標(biāo) > 設(shè)置 > 常規(guī)來增加設(shè)置中的超時。
無效回復(fù)	如果您的服務(wù)器發(fā)送不正確的響應(yīng)編碼錯誤或無效的標(biāo)頭，Postman 可能無法解釋響應(yīng)。
版本	Postman 支持 TLS 1.2 及更高版本，如果您使用的是較舊的瀏覽器或操作系統(tǒng)，則可能不受支持。
郵遞員錯誤	Postman 可能會向您的 API 服務(wù)器發(fā)出無效請求。如果可用，您可以通過檢查服務(wù)器日志來確認(rèn)這一點。如果您認(rèn)為這種情況正在發(fā)生，請使用GitHub 問題跟蹤器聯(lián)系 Postman 團(tuán)隊。
未解決的變量	未解析的變量未在可用于使用它的請求的活動范圍內(nèi)定義。有關(guān)發(fā)生這種情況的原因以及如何解決問題的更多信息，請參閱修復(fù)未解析的變量。
CORS	如果Postman Web 應(yīng)用程序無法發(fā)送您的請求，您可能會遇到跨源資源共享 (CORS) 錯誤。確保您使用最好的Postman Agent來滿足您的要求。

獲得幫助

如果您的請求仍有問題，您可以通過以下幾種方式獲得幫助：

• 在Postman 論壇中尋求社區(qū)幫助。
• 如果您認(rèn)為問題出在 Postman 本身，請在 GitHub 上搜索問題跟蹤器以檢查是否有人已經(jīng)報告了該問題以及是否有已知的解決方案。
• 如果您需要包含機(jī)密數(shù)據(jù)，請向Postman 支持提交支持請求，包括您的控制臺日志。