故障排除请求

如果你的 API 请求未按预期运行，可能有多种原因。要找出问题所在，你可以使用 Postman 控制台对你的请求进行故障排除。本指南还列出了常见问题及其原因。

本指南专门讨论对 API 请求进行故障排除。要解决 Postman 应用程序的问题，请参阅 解决应用程序问题 。要解决 Postman 监视器的问题，请参阅 监视器故障排除 。

在控制台中调试

Postman 发送的每个请求都记录在控制台中，因此你可以查看发送请求时发生的详细信息。这意味着当 API 未按预期运行时，你可以使用 Postman 控制台帮助调试你的请求。在工作时保持控制台打开将增加调试时网络调用和日志消息的可见性。

Postman 控制台记录以下信息：

• 发送的主要请求，包括所有底层请求 header、变量值和重定向
• 用于请求的代理配置和证书
• 网络信息，例如 IP 地址、密码和使用的协议
• 来自测试或预请求脚本的日志语句和异步请求
• 在 Postman 处理之前由服务器发送的原始响应

监控结果记录到单独的控制台。有关如何查看监视器运行日志的更多信息，请参阅 查看监视器结果 。

打开控制台

通过在 Postman 页脚中选择 控制台来打开控制台。在 Postman 桌面应用程序中，你还可以选择⌘+Option+C或Ctrl+Alt+C。

从控制台查看请求错误

如果 Postman 无法发送你的请求，或者如果它没有收到你发送请求的 API 的响应，你将收到一条错误消息。此消息将包含问题概述和指向控制台的链接，你可以在其中访问有关请求的详细信息。

选择“在控制台中查看”以检查控制台中的请求详细信息，并了解有关出错原因的更多信息。

控制台导航

控制台显示网络信息以及每个请求的请求和响应 header 和正文，以及来自你的脚本的任何控制台输出消息。

在所有日志下按日志消息类型过滤。选择更多操作图标 以打开或关闭时间戳和网络信息。

默认情况下，控制台将记录最后 5000 条消息和 24 小时。选择清除以清空列表。

使用日志语句

在测试脚本的适当位置使用日志语句可以帮助你调试请求。Postman 接受以下日志语句：

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

常见问题

如果你在发送请求时遇到的问题未在此处列出，请参阅 获取帮助 以获取有关如何联系 Postman support 的信息。

问题	解决问题
连通性	如果 Postman 无法发送你的请求，你可能遇到了连接问题。通过尝试在网络浏览器中打开一个页面来检查你的连接。
防火墙	一些防火墙可能被配置为阻止非浏览器连接。如果发生这种情况，你需要联系你的网络管理员以使 Postman 工作。
代理配置	如果你使用代理服务器发出请求，请检查你的配置。默认情况下，Postman 使用操作系统网络设置中配置的代理设置。Postman 控制台 将提供有关代理服务器的调试信息。
SSL 证书	你可能会在使用 HTTPS 连接时遇到问题。 你可以在设置 中关闭 SSL 证书验证，方法是选择设置图标 > 设置 > 常规。如果这没有帮助，你的服务器可能正在使用客户端 SSL 连接，你可以通过选择设置图标 > 设置 >证书来配置该连接。使用 Postman 控制台 确保将正确的 SSL 证书发送到服务器。
客户证书	你的 API 服务器可能需要客户端证书。你可以通过选择设置图标 > 设置 > 证书在 设置 中 添加客户端证书 。
错误的请求 URL	如果你在请求中使用变量或路径参数，请通过打开控制台 确保最终地址的结构正确，它将显示你的请求在执行时发送到的 URL。未解析的请求变量可能导致无效的服务器地址。
协议不正确	检查你是否在 URL 中使用https://而不是http://（或相反）。
短超时	如果你在 Postman 中配置了一个较短的超时时间，请求可能会在完成之前超时，从而导致错误。要避免此问题，请通过选择设置图标 > 设置 > 常规来增加 设置 中的超时。
无效回复	如果你的服务器发送不正确的响应编码错误或无效的 header，Postman 可能无法解释响应。
版本	Postman support TLS 1.2 及更高版本， 如果你使用的是较旧的浏览器或操作系统，则可能不受支持 。
Postman 错误	Postman 可能会向你的 API 服务器发出无效请求。如果可用，你可以通过检查服务器日志来确认这一点。 如果你认为这种情况正在发生，请使用 GitHub 问题跟踪器 联系 Postman 团队。
未解决的变量	未解析的变量未在可用于使用它的请求的活动范围内定义。有关发生这种情况的原因以及如何解决问题的更多信息，请参阅修复 未解析的变量 。
CORS	如果 Postman Web 应用程序 无法发送你的请求，你可能会遇到跨源资源共享 (CORS) 错误。确保你使用最好的 Postman Agent 来满足你的要求。

获得帮助

如果你的请求仍有问题，你可以通过以下几种方式获得帮助：

• 在 Postman 论坛 中寻求社区帮助。
• 如果你认为问题出在 Postman 本身，请在 GitHub 上搜索 问题跟踪器以检查是否有人已经报告了该问题以及是否有已知的解决方案。
• 如果你需要包含机密数据，请向 Postman support 提交支持请求，包括你的控制台日志。