Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
如果在连接到 Azure DevOps 中的项目时遇到问题，请按照以下故障排除步骤解决常见连接问题。
先决条件
| 类别 | 要求 |
|---|---|
| 项目访问权限 | 项目成员. |
登录疑难解答
Azure DevOps 支持两种类型的标识进行登录：Microsoft个人帐户和 Microsoft Entra 帐户。 如果尝试访问的组织已连接到 Microsoft Entra 租户，则只能使用 Microsoft Entra 帐户（成员或 B2B 来宾）登录。
401 - 未授权
最常见的登录错误是 401 未授权，当标识无权访问组织或组织内的资源时，会发生此错误。 以下列表概述了 401 错误的最常见原因：
- 标识不是组织的成员。
- 你尝试使用别名登录，而不是用户主体名称（UPN）。
- 你的身份对尝试访问的项目或资源没有读取权限。
- 你的身份是与组织关联的 Microsoft Entra 租户中的 B2B 来宾，你尚未接受 Microsoft Entra 租户邀请。
- 你有一个个人Microsoft帐户，其登录地址与 Microsoft Entra 帐户匹配，并且你使用错误的帐户登录。
你的身份不属于该组织
如果在尝试访问 Azure DevOps 组织时遇到 401 错误，首先应联系 Azure DevOps 管理员以确认标识显示在“用户”列表中。
如果要使用 Microsoft Entra ID 帐户进行身份验证，则“用户”列表中显示的标识必须与Microsoft Entra 租户中的用户主体名称（UPN）匹配。 如果要使用个人Microsoft帐户进行身份验证，则“用户”列表中的标识必须与主帐户匹配。
如果你是连接到 Azure DevOps 组织的 Microsoft Entra 租户中的 B2B 来宾，请确保来宾租户中的 UPN 与主租户中的 UPN 完全匹配，包括大小写。
注释
B2B 来宾在 Microsoft Entra ID 门户中显示为 UPN 格式 {username}_{homeDomain}#EXT#@{guestDomain}。
{username}_{homeDomain}需要与主租户中的 UPN 匹配，并将_替换为@。
你尝试使用别名登录，而不是用户主体名称（UPN）
Azure DevOps 不支持登录别名。 如果使用 Microsoft Entra 帐户进行身份验证，则必须使用用户主体名称（UPN）登录;如果使用个人帐户进行身份验证，则必须使用主帐户登录。
例如，如果您的 UPN 是 12345@mycompany.com 并且您配置了登录别名为 MyName@mycompany.com，则您的管理员应将 12345@mycompany.com 添加到组织中，并且在登录过程中您应使用 12345@mycompany.com。 不能使用 MyName@mycompany.com 来登录 Azure DevOps。
你的标识对尝试访问的项目或资源没有读取权限。
你可能有权访问 Azure DevOps 组织，但对尝试访问的特定项目或资源没有权限。 权限通常由内置或自定义组中的成员身份（如项目参与者或项目读取者组）控制。 如果您能登录到组织的根目录（https://dev.azure.com/{orgName}）但无法访问更具体的链接（如https://dev.azure.com/{orgName}/{projectName}），请联系 Azure DevOps 管理员，确保您在尝试访问的资产上至少被分配了“读取”权限。
你的身份是一个与组织相关联的 Microsoft Entra 租户中的 B2B 来宾，但尚未接受 Microsoft Entra 租户邀请。
若要以 B2B 来宾身份登录到 Azure DevOps，请接受发送给电子邮件的 Microsoft Entra 租户邀请。
Microsoft Entra 租户管理员可以查看是否接受来自 Azure 门户的邀请，并根据需要触发要发送的新通知：
- 转到 https://portal.azure.com 。
- 转到Microsoft Entra ID 门户。
- 选择“ 管理>用户”。
- 选择来宾用户。
- 在 “概述 ”页上，查找 B2B 邀请磁贴。
- 如果状态仍为“等待接受”，可以使用“重新发送邀请”链接来触发发送新电子邮件。
你有一个具有与 Microsoft Entra 帐户匹配的登录地址的个人Microsoft帐户，并且使用错误的帐户登录
对于未连接到 Microsoft Entra 租户的组织，可以使用Microsoft个人帐户或 Microsoft Entra 帐户登录。 首次登录 Azure DevOps 组织时选择的帐户决定了今后需要使用的帐户。 Azure DevOps 将这些帐户视为独立的身份，因此您无法互换用于登录的帐户。
如果要更改用于访问组织的标识，请让管理员从组织中删除并读取你。 此操作将使你的身份回到等待状态，查看你是否使用 Microsoft 个人帐户或 Microsoft Entra 版本的帐户。
我们通常建议不要匹配个人帐户和Microsoft Entra 帐户，因为这可能会导致不必要的混淆。 可以按照此处的说明重命名个人帐户，使其不再与 Microsoft Entra 帐户匹配： 更改Microsoft帐户的电子邮件地址或电话号码 - Microsoft支持。
如果你认为你是组织的成员，但收到此错误页， 请联系支持人员。
排查连接问题
若要解决连接问题，请完成以下步骤：
- 注销浏览器。 为此，请选择 Visual Studio 注销 链接。
- 在浏览器中删除 Cookie。 若要在大多数浏览器中删除 Cookie，请选择 Ctrl++
- 打开 Microsoft Edge 并删除浏览器 Cookie。 Visual Studio IDE 使用 Microsoft Edge Cookie。
- 关闭所有浏览器并关闭 Visual Studio IDE。
- 使用专用浏览器会话重试连接。 如果问题与 Visual Studio IDE 有关，请删除连接，然后在团队资源管理器中读取连接。
我仍然需要帮助
如果在完成本指南后仍被阻止， 请联系Microsoft支持部门。 技术支持要求您提供登录尝试的浏览器记录以进行故障排除。 根据 捕获浏览器跟踪以进行故障排除 中的说明，确保跟踪包含支持团队需要调查问题的信息。