> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XBOX 服务登录故障排除

> 诊断常见的 XBOX 服务登录失败问题，包括开发过程中的沙盒不匹配、测试账户访问以及服务配置发布问题。

有几个常见问题可能会导致登录困难。

## 沙盒问题

您应当熟悉沙盒的概念及其与 XBOX 服务的关系。
请参阅 [XBOX 服务沙盒概述](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox)。

沙盒在零售发布之前强制执行内容隔离和访问控制。
无法访问您开发沙盒的用户无法执行与您游戏相关的任何读取或写入操作。
您还可以将服务配置的各种变体发布到不同的沙盒中进行测试。

以下讨论了使用沙盒时需要注意的事项。

#### 开发者账户没有访问运行时所需的正确沙盒的权限

要登录正在开发中的游戏，必须使用测试账户（也称为 *开发账户*）或已授权的开发者账户。

* 请确保您正在尝试使用其中之一登录。
* 测试账户在 Partner Center 中创建。
* 您可以在 Partner Center 上授权与 XBOX 服务关联的开发者账户，地址为 [https://partner.microsoft.com/xboxconfig/TestAccounts/](https://partner.microsoft.com/xboxconfig/TestAccounts/)。
* 确保账户可以访问您的游戏发布到的沙盒。
* 您在 Partner Center 中创建的测试账户会继承创建它们的 Partner Center 账户的权限。

### 您的设备未处于正确的沙盒

您正在开发的设备必须设置为开发沙盒。
在 XBOX One（或更高版本）上，使用 *XBOX One Manager* 设置沙盒。

对于 Windows 10 桌面版，请使用位于 XBOX SDK 安装的 `Tools` 目录中的 `SwitchSandbox.cmd` 脚本。

### 您的游戏服务配置未发布到正确的开发沙盒

请确保您的游戏服务配置已发布到某个开发沙盒。

除非游戏已发布到相同的沙盒，否则您无法在给定开发沙盒中登录到 XBOX network（也称为 XBOX Live）。

要将游戏发布到相同的沙盒，请参阅“设置沙盒”一文中的[沙盒 ID](/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes#sandbox-ids)部分。

要将您的 Partner Center 配置发布到沙盒，请前往 Partner Center 上的 XBOX 服务配置页面，并选择 **测试** 按钮。

## ID 配置错误

配置游戏需要几个 ID。

一些需要注意的事项：

* 确保您的 App ID 已正确输入到 Partner Center。
* 确保您的 PFN 已正确输入到 Partner Center。
* 确保 appxmanifest 中的“Package Identity”是正确的。这在 Partner Center 的 App Identity 部分中显示为“Package/Identity/Name”。

## Title ID 或 SCID 未正确配置

对于 XDK 和 GDK 游戏，这些值在 `package.appxmanifest` 中设置。

## 基于错误代码进行调试

以下是您在登录时可能看到的一些错误代码，以及可用于调试这些错误的步骤。
错误代码显示如下：

<img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/sign_in_error.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=168ef508b3147a49336dd21791e1c20c" alt="0x8015DC12 登录错误屏幕截图" width="648" height="628" data-path="images/gdk/services/sign_in_error.png" />

### 0x80860003 应用程序被禁用或配置错误

1. 尝试删除您的 PFX 文件。

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pfx_file.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=b790352df1c50e0dbdce6bb7f4e75f01" alt="解决方案资源管理器中的 pfx 文件" width="534" height="561" data-path="images/gdk/services/pfx_file.png" />

   如果您没有使用在 Partner Center 中预配应用所用的 Microsoft 账户登录 Visual Studio，Visual Studio 将根据您的个人 Microsoft 账户或域账户自动生成一个签名 pfx 文件。
   构建 appx 包时，Visual Studio 会使用该自动生成的 pfx 对包进行签名，并更改 `package.appxmanifest` 中包标识的 "publisher" 部分。
   因此，生成的位（特别是 `appxmanifest.xml`）将具有与您预期使用的不同的包标识。

2. 仔细检查您的 `package.appxmanifest` 是否设置为与 Partner Center 中游戏相同的应用程序标识。
   您可以右键单击项目并选择 **Store** -> **Associate App With Store...**，如以下屏幕截图所示；或者，手动编辑 `package.appxmanifest`。

   <img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/appxmanifest_binding.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=376612e98a1f724b54de5b1344a7dd5a" alt="与商店关联" width="851" height="852" data-path="images/gdk/services/appxmanifest_binding.png" />

### 0x8015DC12 内容隔离错误

此错误意味着设备或用户无法访问指定的游戏。

1. 这可能意味着您没有使用测试账户尝试登录，或者您的测试账户无法访问您登录的沙盒。
   请仔细检查 [XBOX 服务测试账户](/services/xbox-services/develop/test-accounts/live-test-accounts)中有关创建测试账户的说明。
   如有必要，请创建具有相应沙盒访问权限的新测试账户。

   您可能需要从 Windows 10 中删除旧账户，您可以通过“开始”菜单进入“设置”，然后进入“账户”来执行此操作。

2. 仔细检查您的游戏是否已发布到您尝试使用的沙盒。
   请参阅“设置沙盒”中的[沙盒 ID](/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes#sandbox-ids)部分。

### 0x87DD000E 游戏未授权

仔细检查您的设备是否设置为正确的开发沙盒，以及用户是否具有沙盒访问权限。

按上述说明检查 Partner Center 绑定和 App ID 设置。

如果您遇到此处未描述的错误，请参阅 `xbox::services::xbox_live_error_code` 文档中的错误列表，以获取有关错误代码的更多信息。
您还可以参考 XSAPI 头文件中的 `errors.h`。

如果您无法使用您的游戏登录，请在[论坛](https://forums.xboxlive.com)上发布支持主题，或与您的账户经理联系。


## Related topics

- [用户登录](/zh-CN/services/xbox-services/fundamentals/identity/auth/live-authentication-nav.md)
- [身份验证](/zh-CN/services/xbox-services/fundamentals/identity/auth/index.md)
- [XBOX Live 服务 API 故障排除](/zh-CN/services/xbox-services/develop/troubleshooting/live-troubleshooting-apis.md)
- [故障排除](/zh-CN/services/xbox-services/develop/troubleshooting/index.md)
- [登录和沙盒错误故障排除](/zh-CN/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
