调试请求

当 API 请求的行为不符合预期时，Apidog 提供了强大的调试工具，帮助你快速诊断并解决问题。本指南说明如何使用 Apidog Console 排查问题，并概述常见问题及其解决方案。

实际请求

发送请求后，你可以切换到 Actual Request 标签页，查看实际发送到服务器的完整详细信息，包括请求 URL、头部和主体。

此视图对于验证变量、参数和身份验证详情是否在请求发送前被正确解析尤其有用。

如果继续向下滚动，你还可以看到使用各种编程语言发送此请求的客户端代码，这有助于你在自己的应用程序中实现相同的请求。

在 Console 中调试

你可以在请求执行期间随时使用 Console 输出日志，帮助定位请求或脚本中的问题。Apidog 支持以下 Console 方法：

变量提取、数据库操作和其他自动化流程会自动将其结果输出到 Console，从而让你能够了解脚本执行情况。

常见问题

下表概述了发送请求时可能遇到的常见问题及其解决方案：

问题	解决方案
连接性	如果 Apidog 无法发送你的请求，可能存在连接问题。要检查这一点，请尝试在网页浏览器中打开一个网页。
防火墙	某些防火墙可能被设置为阻止非浏览器发起的连接。在这种情况下，你需要联系网络管理员，以便 Apidog 正常运行。
代理设置	如果你使用代理服务器发送请求，请验证你的配置。默认情况下，Apidog 使用操作系统网络设置中配置的代理设置。Apidog Console 将提供有关代理服务器的调试详情。
SSL 证书	你可能会遇到 HTTPS 连接方面的困难。你可以在 Settings 中禁用 SSL 证书验证：点击设置图标，然后导航到 Settings > General。如果这无法解决问题，你的服务器可能正在使用客户端 SSL 连接，可通过点击设置图标并转到 Settings > Certificates 进行配置。使用 Apidog Console 确保正确的 SSL 证书已发送到服务器。了解有关管理证书的更多信息。
客户端证书	你的 API 服务器可能需要客户端证书。你可以在 Settings 中添加客户端证书：点击设置图标，然后转到 Settings > Certificates。
请求 URL 不正确	如果你在请求中使用变量或路径参数，请通过检查 Postman Console 来再次确认最终地址是否准确；Postman Console 会显示请求执行时实际发送到的 URL。未解析的请求变量可能导致服务器地址不正确。
协议不正确	请确保在 URL 中使用正确的协议（http:// 或 https://）。
超时时间过短	如果在 Apidog 中配置了较短的超时时间，请求可能会在完成前超时，从而导致错误。为避免这种情况，请点击设置图标，然后导航到 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 中调试

常见问题