Skip to main content

此版本的 GitHub Enterprise Server 将于以下日期停止服务 2026-03-17. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

双因素身份验证问题故障排除

如果在使用 2FA 验证身份时遇到问题,可以尝试对配置的身份验证方法进行故障排除。

如果在使用双因素身份验证 (2FA) 验证身份时收到“双因素身份验证失败”错误提示,说明输入的验证码不正确。 可以先对配置的身份验证方法进行故障排除,再尝试恢复帐户。

使用 TOTP 应用进行身份验证故障排除

使用正确的应用

使用 TOTP 应用进行身份验证时,GitHub 不会向你发送任何内容;你需要根据设置 2FA 时保存到 TOTP 应用的密钥,为 GitHub 提供一个有效的代码。 找到最初用于设置 2FA 的应用或程序,并从中检索验证码。

检查设备的日期和时间

TOTP 码是基于时间的。 如果手机或计算机上的时钟与 GitHub 的服务器不同步,则该码无效。 确保设备上的日期、时间和时区是由网络提供商自动设置的。 在大多数移动设备上,这意味着启用“Set automatically”选项****。

等待新验证码,收到后立即输入

验证码每 30 秒变化一次。 打开 TOTP 应用,等待下一个验证码,并在它出现后立即输入。 避免键入空格或额外的字符,因为它们会使验证码无效。

验证你使用了正确的帐户入口

大多数 TOTP 应用支持单网站多帐户。 请确保从应用中正确的入口读取验证码。 为其他帐户生成的验证码不起作用。

从 TOTP 备份还原

许多 TOTP 应用支持云备份或密钥导出。 如果丢失或重置设备,可基于应用备份将 2FA 数据还原到新设备。 有关说明,请参阅应用的文档。

在故障排除不起作用的情况下恢复帐户

如果你已尝试故障排除,但仍遇到问题,则可以尝试使用另一种方法(如果已在帐户上预配置)进行身份验证,例如密钥、 或安全密钥。 有关详细信息,请参阅“使用双重身份验证访问 GitHub”。

如果没有其他身份验证方法,则需要尝试恢复帐户。 有关帐户恢复的详细信息,请参阅“丢失 2FA 凭据时恢复帐户”。

使用恢复代码进行故障排除

如果在使用恢复代码时收到“恢复代码身份验证失败”错误提示,说明输入的代码无效。 可以尝试对恢复代码进行故障排除。

一次使用一个代码

一组恢复代码包含多个代码。 一个代码为 10 个字母数字字符,中间用连字符连接:xxxxx-yyyyy

尝试使用其他代码

每个代码均为一次性使用:一旦用于身份验证,就不能再次使用。 尝试使用代码集内一个不同的代码。

检查你使用的是不是正确的一组代码

禁用 2FA 后再重新启用时,系统将创建一组新的代码,这会使原先的那一组代码失效。 每当生成一组新代码时,恢复代码也会失效。 即使认为自己可能没有另一组代码,也可以尝试在设备、备份和密码管理器中搜索。 它们具有默认文件名 github-recovery-codes.txt

其他阅读材料