Postman 排除故障請(qǐng)求

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

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

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

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

Postman 控制臺(tái)記錄以下信息：

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

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

打開控制臺(tái)

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

從控制臺(tái)查看請(qǐng)求錯(cuò)誤

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

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

控制臺(tái)導(dǎo)航

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

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

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

使用日志語(yǔ)句

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

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

常見問(wèn)題

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

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

獲得幫助

如果您的請(qǐng)求仍有問(wèn)題，您可以通過(guò)以下幾種方式獲得幫助：

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