OAuth令牌链接报错排查指南

本文档详细介绍了在处理OAuth令牌链接过程中可能遇到的常见报错及其解决方案，包括客户端凭据不正确、重定向URI不匹配、验证码错误等问题。通过本文，用户将能够更好地理解和解决这些问题，确保OAuth应用的正常运行。此外，本文还提供了在国内无法连接原API时的替代解决方案，确保用户能够顺利完成OAuth令牌的配置和使用。

客户端凭据不正确

错误描述

在请求 OAuth 令牌链接时，如果传递的 client_id 或 client_secret 不正确，会收到错误响应。这通常意味着提供的客户端凭据不匹配或输入错误。

{
  "error": "incorrect_client_credentials",
  "error_description": "The client_id and/or client_secret passed are incorrect.",
  "error_uri": "/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors/#incorrect-client-credentials"
}

错误原因

造成这个错误的原因可能是由于在配置 OAuth 应用时，输入的客户端 ID 或密钥有误。确保从 GitHub 获取的凭据是最新且正确的。

解决方法

为了避免此错误，应仔细核对 client_id 和 client_secret，确保其与在 GitHub 上注册的应用程序信息一致。

重定向URImismatch

错误描述

当提供的 redirect_uri 与在 OAuth 应用中注册的回调 URL 不匹配时，会触发此错误。此错误确保应用程序的重定向 URL 是安全和可信的。

{
  "error": "redirect_uri_mismatch",
  "error_description": "The redirect_uri MUST match the registered callback URL for this application.",
  "error_uri": "/apps/managing-oauth-apps/troubleshooting-authorization-request-errors/#redirect-uri-mismatch2"
}

错误原因

该错误通常是由于在应用程序中未正确配置回调 URL，或者在请求中提供了错误的 redirect_uri 参数。

解决方法

要解决此问题，请确保请求中的 redirect_uri 与 OAuth 应用中注册的回调 URL 完全匹配，或者忽略此参数以使用默认值。

验证码错误

错误描述

当传递的验证码不正确、已过期或不匹配时，会收到验证码错误。这可能是由于用户在授权过程中的操作不当导致的。

{
  "error": "bad_verification_code",
  "error_description": "The code passed is incorrect or expired.",
  "error_uri": "/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors/#bad-verification-code"
}

错误原因

此错误通常是由于用户在授权过程中未能正确完成步骤，或验证码在过期前未使用。

解决方法

若要解决此问题，应重新启动 OAuth 授权过程，以获取新的验证码并确保在有效期内使用。

未经验证的用户电子邮件

错误描述

如果用户尝试生成访问令牌时，其主要电子邮件地址尚未经过 GitHub 验证，则会出现此错误。

{
  "error": "unverified_user_email",
  "error_description": "The user must have a verified primary email.",
  "error_uri": "/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors/#unverified_user_email"
}

错误原因

该错误通常由用户未在 GitHub 上验证其主要电子邮件地址引起。

解决方法

解决此问题的方法是提示用户在 GitHub 上验证其主要电子邮件地址，以便生成用户访问令牌。

帮助和支持

寻求帮助

如果在使用 OAuth 令牌链接时遇到问题，可以访问 GitHub 社区论坛，向其他用户寻求帮助和建议。

联系支持

对于更复杂的问题或在社区中无法解决的情况，可以直接联系 GitHub 支持团队以获得专业帮助。

相关链接

请参考以下链接以获取更多帮助：GitHub 支持

替代API使用指南

替代 API 概述

由于原始 API 的访问限制，用户可以选择使用新的替代 API 来解决连接问题。

新 API 配置

通过将 OAuth 令牌链接更改为新的 API 地址，用户可以有效地绕过连接问题。新的 API 地址是：

• https://api-cf.nn.ci/alist/ali_open/token
• https://api.xhofe.top/alist/ali_open/token

详细信息

有关详细信息和讨论，请访问 GitHub 讨论页面。

OAuth令牌链接配置更新

更新必要性

更新 OAuth 令牌链接配置有助于解决由 API 访问限制引起的连接问题，提高应用程序的可靠性。

更新步骤

首先，检查当前的 OAuth 应用配置，特别是令牌请求 URL。更新为推荐的替代 API 地址可显著改善连接性。

更新后测试

在完成配置更新后，务必进行测试以确保新的 OAuth 令牌链接能够正常工作，避免意外的访问中断。

FAQ

问：在请求 OAuth 令牌链接时收到 incorrect_client_credentials 错误该怎么办？

• 答：此错误表示提供的 client_id 或 client_secret 不正确。通常是由于配置 OAuth 应用时输入的客户端 ID 或密钥有误。解决方法是仔细核对这些凭据，确保它们与在 GitHub 上注册的应用程序信息一致。

问：如何解决 OAuth 令牌链接中的 redirect_uri_mismatch 错误？

• 答：redirect_uri_mismatch 错误发生在提供的 redirect_uri 与注册的回调 URL 不匹配时。解决此问题，需要确认请求中的 redirect_uri 与 OAuth 应用中注册的回调 URL 完全一致，或者忽略此参数以使用默认值。

问：为什么会收到 bad_verification_code 错误？

• 答：此错误通常由于用户在授权过程中未能正确完成步骤，或者验证码在过期前未使用。若要解决此问题，应重新启动 OAuth 授权过程，以获取新的验证码并确保在有效期内使用。

问：unverified_user_email 错误如何处理？

• 答：当用户的主要电子邮件地址尚未在 GitHub 上验证时，会收到此错误。解决方法是提醒用户验证其主要电子邮件地址，以便生成用户访问令牌。

问：如何使用替代 API 解决 OAuth 令牌链接的访问限制问题？

• 答：用户可以通过将 OAuth 令牌链接更改为新的 API 地址来解决连接问题。这些替代 API 地址是：https://api-cf.nn.ci/alist/ali_open/token 和 https://api.xhofe.top/alist/ali_open/token。更新后，应测试新配置以确保其正常工作。