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

# 針對登入和沙箱錯誤進行疑難排解

> 使用 XblPCSandbox、預檢檢查清單、錯誤碼參考和 Partner Center 設定檢查，診斷 PC 上的 XBOX Live 登入和沙箱錯誤。

本文可協助您診斷並修正遊戲在 PC 上的開發沙箱中常見的登入和沙箱相關錯誤。

## 本文內容

* [預檢檢查清單](#preflight-checklist)
* [診斷流程圖](#diagnostic-flowchart)
* [帳戶和沙箱錯誤](#account-and-sandbox-errors)
* [設定錯誤](#configuration-errors)
* [遊戲特定的疑難排解](#game-specific-troubleshooting)
* [其他疑難排解](#additional-troubleshooting)
* [錯誤碼快速參考](#error-code-quick-reference)

***

## 預檢檢查清單

在調查特定錯誤之前，請先完成此檢查清單。大多數登入問題都是由於其中某個項目設定錯誤所造成的。在繼續進行下方的診斷流程圖和錯誤章節之前，請先確認下列**所有**項目。

> [!NOTE]
>
> 事先安裝 XblPCSandbox.exe 工具至關重要。
> 如需如何取得此工具的詳細資訊，請參閱[沙箱概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)

### 環境檢查

這些項目會影響您登入 XBOX 服務 (包括 XBOX 應用程式) 的能力。請先檢查這些項目。

***

### ✅ 1. 檢閱沙箱識別碼沒有任何錯字

請確定沙箱識別碼的輸入正確。

**如何檢查：**

```cmd theme={null}
XblPCSandbox /get
```

將輸出與 Partner Center 中 **Gameplay settings** 頁面上顯示的沙箱進行比較。
您可以使用 [https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId\]，將](https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId]，將) \[productId] 參數取代為您各自的*產品識別碼*。

**如何修正：**

```cmd theme={null}
XblPCSandbox <your sandbox ID>
```

如需切換沙箱的詳細指示，請參閱[沙箱概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)。

***

### ✅ 2. 您的沙箱正確

您的 PC 必須位於遊戲 XBOX 服務設定已發佈至的同一個開發沙箱中。

**如何檢查：**

```cmd theme={null}
XblPCSandbox /get
```

將輸出與 Partner Center 中 **Gameplay settings** 頁面上顯示的沙箱進行比較。
您可以使用 [https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId\]，將](https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId]，將) \[productId] 參數取代為您各自的*產品識別碼*。

**如何修正：**

```cmd theme={null}
XblPCSandbox <your sandbox ID>
```

如需切換沙箱的詳細指示，請參閱[沙箱概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)。

***

### ✅ 3. 您的測試帳戶有效

測試帳戶可能會因為多種原因而失效。請確認下列所有項目：

#### 帳戶對沙箱的存取權未到期

測試帳戶對沙箱的存取權有到期日。沙箱存取權已到期的帳戶無法登入沙箱。

**如何檢查：**

1. 前往 [Partner Center](https://partner.microsoft.com/dashboard)。
2. 選取 **Apps and Games**
3. 選取 **XBOX Test accounts** (或前往[測試帳戶管理](https://partner.microsoft.com/dashboard/xbox/testaccounts))。
4. 找到您的測試帳戶，並檢查 **Access Expires** 和 **Status** 欄。

**如何修正：**

如果帳戶已到期，請建立新的測試帳戶，或延長現有帳戶的到期日。

#### 帳戶具有您沙箱的存取權

建立測試帳戶時，您必須授與其特定沙箱的存取權。

**如何檢查：**

1. 在 Partner Center 中，前往 **XBOX services** > **Test accounts**。
2. 選取您的測試帳戶。
3. 確認您的開發沙箱已列在帳戶的沙箱存取權下。

**如何修正：**

編輯測試帳戶，並將您的開發沙箱新增至其存取清單。

#### 認證正確

請確定您使用的是測試帳戶正確的電子郵件地址和密碼。測試帳戶電子郵件地址通常以 `@xboxtest.com` 結尾。

***

### ✅ 4. XBOX 遊戲元件是最新版本

XBOX 服務依賴您 PC 上的 XBOX 應用程式和 Gaming Services 元件。這兩者中任一個的版本過舊，都可能導致非預期的登入失敗。

**如何檢查：**

1. 請依照 [Game Repair Tool](https://support.xbox.com/en-MD/help/games-apps/troubleshooting/gaming-services-repair-tool) 提供的資訊操作

***

### ✅ 5. 重新啟動您的 PC

有時登入所需的背景服務 (例如 XBOX Live Auth Manager 或 Gaming Services) 會進入不良狀態。重新啟動 PC 可以解決上述步驟無法察覺的暫時性問題。

在這麼做之前，請務必透過意見反應中樞提交錯誤，以便在未來的版本中追蹤和解決。

您可以使用下列命令來執行此動作：

```cmd theme={null}
XblPCSandbox /feedback
```

或者，如果直接從意見反應中樞提交，請選擇 **Category: Gaming and XBOX** 和 **Area: Developer Tools**

**何時執行此動作：**

如果您已確認上述所有環境檢查，但登入仍然失敗，請在繼續進行專案檢查之前重新啟動 PC 並再試一次。

***

### 專案檢查

這些項目會特別影響從您的遊戲登入。如果您可以登入 XBOX 應用程式，但無法從遊戲登入，請從這裡開始。

***

### ✅ 6. 您的識別碼與 Partner Center 相符

您 `MicrosoftGame.config` 中的識別碼必須與 Partner Center 中的值完全相符。只要有一個值不符，就會導致無法登入。

**如何檢查：**

開啟您的 `MicrosoftGame.config`，並將這些值與 Partner Center 進行比較：

| MicrosoftGame.config 欄位 | 在 Partner Center 中的位置 |
| - | - |
| `StoreId` | **Game Setup** > **Identity details** > **Show details** > Store ID |
| `Identity/Name` | **Game Setup** > **Identity details** > **Show details** > Package/Identity/Name |
| `Identity/Publisher` | **Game Setup** > **Identity details** > **Show details** > Package/Identity/Publisher |
| `TitleId` | **XBOX services** > **XBOX Settings** > Title ID (**十六進位**值，而非十進位) |
| `MSAAppId` | **XBOX services** > **XBOX Settings** > MSA App ID (可以是 GUID 或十六進位) |

此外，請檢查 **SCID** (服務設定識別碼)。SCID 不在您的 `MicrosoftGame.config` 中，而是作為參數傳遞給 [XblInitialize](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize.md) 方法。您可以在 Partner Center 的 **XBOX services** > **XBOX Settings** 下找到它。

> [!TIP]
>
> 使用 [MicrosoftGame.config 編輯器](https://docs.xbox.com/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Editor.md)中的**市集關聯精靈**自動連結您的遊戲，以減少錯字的機會。

***

### ✅ 7. XBOX 服務設定已發佈至您的沙箱

即使在 Partner Center 中儲存了變更，在您將其發佈至開發沙箱之前，這些變更都**不會**生效。

**如何檢查：**

1. 前往 [Partner Center](https://partner.microsoft.com/dashboard)。
2. 選取您的產品。
3. 瀏覽至 **XBOX services** > **Gameplay settings**。
4. 選取您開發沙箱的索引標籤。
5. 檢查發佈狀態。

**如何修正：**

如果變更尚未發佈，請選取 **Publish** 將其推送至您的開發沙箱。等待大約 **30 分鐘**讓變更傳播，然後再進行測試。

> [!WARNING]
>
> 在 XBOX Settings 頁面上按一下 **Save\*\*\*\*不會**發佈變更。您必須從 **Gameplay settings** 頁面明確發佈。

***

### ✅ 8. 已啟用 PC 平台

如果您在 PC 上進行開發，就必須為您的遊戲啟用 **Windows 10 PC** (及更新版本) 平台。如果沒有啟用，登入會失敗並出現錯誤 `0x87dd0005 (AM_E_XAST_UNEXPECTED)`。

**如何檢查：**

1. 前往 [Partner Center](https://partner.microsoft.com/dashboard)。
2. 選取您的產品。
3. 瀏覽至 **XBOX services** > **XBOX Settings**。
4. 確認已**核取** **Windows 10 PC** 核取方塊。對於最新的 Windows 版本也請執行此動作。

**如何修正：**

1. 核取 **Windows 10 PC** 核取方塊。
2. 選取 **Save**。
3. 前往 **Gameplay settings**，並將您的設定**發佈**至您的開發沙箱。
4. 等待大約 **30 分鐘**再進行測試。

***

## 診斷流程圖

如果預檢檢查清單沒有解決您的問題，請使用此逐步程序來縮小根本原因的範圍。從步驟 1 開始，並依照分支進行。

```
┌─────────────────────────────────────────────────────────┐
│                  Still can't sign in?                   │
│         Start here after completing the                 │
│              Preflight Checklist                        │
└───────────────────────┬─────────────────────────────────┘
                        │
                        ▼
        ┌───────────────────────────────┐
        │  STEP 1: Can you sign in to   │
        │  the Xbox App with your       │
        │  test account?                │
        └───────┬───────────────┬───────┘
                │               │
            YES ▼           NO  ▼
    ┌───────────────┐   ┌──────────────────────────────────────────────┐
    │  Sandbox and  │   │  Sandbox or account                          │
    │  account are  │   │  issue. Check:                               │
    │  working.     │   │                                              │
    │  Go to Step 2 │   │  • Is the sandbox ID correct?                │
    │               │   │  • Is the account access to sandbox expired? │
    └───────┬───────┘   │  • Does the account have sandbox access?     │
            │           │  • Are the credentials right?                │
            │           │  • Is the Xbox App up to date?               │
            │           │  • Is the Xbox App licensed?                 │
            │           │                                              │
            │           │  See: Account & Sandbox Errors below         │
            │           └──────────────────────────────────────────────┘
            ▼
┌───────────────────────────────┐
│  STEP 2: Can you sign in to   │
│  a sample project with your   │
│  game's IDs?                  │
└───────┬───────────────┬───────┘
        │               │
    YES ▼           NO  ▼
┌───────────────┐   ┌──────────────────────────────┐
│  Config is    │   │  Configuration issue.        │
│  working.     │   │  Check:                      │
│  Go to Step 3 │   │                              │
│               │   │  • Are the IDs correct in    │
└───────┬───────┘   │    MicrosoftGame.config?     │
        │           │  • Are the gameplay settings │
        │           │    published to the sandbox? │
        │           │  • Is the PC Platform        │
        │           │    enabled?                  │
        │           │  • Is the SCID correct in    │
        │           │    XblInitialize?            │
        │           │                              │
        │           │  See: Configuration          │
        │           │  Errors below                │
        │           └──────────────────────────────┘
        ▼
┌───────────────────────────────┐
│  STEP 3: Game-specific issue  │
│  The sample works but your    │
│  game doesn't.                │
│                               │
│  • Compare the MicrosoftGame  │
│    .config files              │
│  • Compare the sign-in code   │
│  • Check the error code in    │
│     reference table below     │
└───────────────────────────────┘
```

***

## 帳戶和沙箱錯誤

如果您**無法**登入 XBOX 應用程式 ([診斷流程圖](#diagnostic-flowchart)的步驟 1)，問題出在您的沙箱切換、測試帳戶或 XBOX 應用程式本身。

### 使用者不在此沙箱中 (0x8015DC12)

測試帳戶沒有沙箱的存取權，或遊戲的設定與沙箱不符。

**常見原因和修正方式：**

| 原因 | 修正方式 |
| - | - |
| `MicrosoftGame.config` 中的識別碼與 Partner Center 不符 | 請參閱[檢查清單項目 1](#-1-review_the_sandbox_Id_does_not_have_any_typos) 和[檢查清單項目 2](#-2-your-sandbox-is-correct) |
| 測試帳戶沒有沙箱存取權 | 在 Partner Center 中編輯測試帳戶並新增您的沙箱 |
| 測試帳戶對沙箱的存取權已到期 | 在 Partner Center 中檢查到期日；建立新帳戶或延長期限 |
| 使用隔離沙箱而非共用沙箱 | 在 Partner Center 中檢查沙箱類型；除非您有使用隔離沙箱的特定原因，否則請切換至共用沙箱。請參閱[隔離與共用沙箱](#isolated-vs-shared-sandboxes)。 |

### 沙箱識別碼不正確

常見的錯誤包括：

* 缺少或多出字元：`XDKS1` 而非 `XDKS.1`
* 錯誤的沙箱：切換到與遊戲設定發佈位置不同的沙箱

**如何修正：**

1. 執行 `XblPCSandbox /get`，並將輸出與 Partner Center 進行比較。
2. 使用 Partner Center 中的確切值重新執行 `XblPCSandbox <correct sandbox ID>`。

### 測試帳戶的沙箱錯誤 (Garrison 錯誤)

如果您看到錯誤訊息建議您的帳戶應在不同的沙箱中使用，或 XBOX 身分識別服務在登入期間傳回非預期的錯誤，您可能登入了該測試帳戶錯誤的沙箱。

**如何修正：**

1. 執行 `XblPCSandbox /get` 以確認您的 PC 設定為哪個沙箱。
2. 在 Partner Center 中，前往 **XBOX services** > **Test accounts**，並確認您的測試帳戶具有該沙箱的存取權。
3. 如果沙箱不相符，請切換至正確的沙箱：`XblPCSandbox <correct sandbox ID>`

### XBOX 應用程式授權錯誤 (0x803F8001)

如果您先前未曾在 RETAIL 中開啟 XBOX 應用程式，它可能會無法啟動。

**如何修正：**

1. 切換至 RETAIL：`XblPCSandbox /retail` (或 `XblPCSandbox RETAIL`)
2. 開啟 XBOX 應用程式，並讓它完全啟動。
3. 切換回您的開發沙箱：`XblPCSandbox <your sandbox ID>`

### 找不到 XBOX 應用程式

XBOX 應用程式可在 Microsoft Store 中取得，但**只有在您位於 RETAIL 沙箱時**才能取得。如果您找不到它：

1. 切換至 RETAIL：`XblPCSandbox /retail` (或 `XblPCSandbox RETAIL`)
2. 在 Microsoft Store 中搜尋 "XBOX" 並安裝。
3. 切換回您的沙箱。

***

## 設定錯誤

如果您**可以**登入 XBOX 應用程式，但**無法**在遊戲或範例專案中登入 ([診斷流程圖](#diagnostic-flowchart)的步驟 2)，問題出在您遊戲的 XBOX 服務設定。

### 未啟用 PC 平台 (0x87dd0005, AM\_E\_XAST\_UNEXPECTED)

此錯誤表示未在 Partner Center 中新增 Windows 10 PC 平台。也請檢查更新的版本。

**如何修正：**

1. 在 Partner Center 中，瀏覽至您的產品 > **XBOX services** > **XBOX Settings**。
2. 核取 **Windows 10 PC** 核取方塊。
3. 選取 **Save**。
4. 前往 **Gameplay settings**，並將您的設定**發佈**至您的開發沙箱。
5. 等待 **30 分鐘**，然後再次嘗試登入。

> [!WARNING]
>
> 在 XBOX Settings 頁面上按一下 **Save\*\*\*\*不會**發佈變更。您必須從 **Gameplay settings** 頁面明確發佈，登入才能運作。

### XBOX 服務設定未發佈

在 Partner Center 中儲存的變更，在發佈至您的開發沙箱之前不會生效。

**如何修正：**

1. 在 Partner Center 中前往 **XBOX services** > **Gameplay settings**。
2. 選取您的開發沙箱索引標籤。
3. 選取 **Publish**。
4. 等待大約 **30 分鐘**讓變更傳播。

### MicrosoftGame.config 中的識別碼不正確

登入錯誤的常見原因是 `MicrosoftGame.config` 中有一或多個值不相符。

**如何修正：**

使用 [MicrosoftGame.config 編輯器](https://docs.xbox.com/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Editor.md)中的**市集關聯精靈**來連結您的遊戲並自動填入正確的值。或者，使用[檢查清單項目 1](#-1-your-ids-match-partner-center) 根據 Partner Center 手動確認每個值。

### XblInitialize 中的 SCID 不正確

SCID **不在** `MicrosoftGame.config` 中，而是作為參數傳遞給 [XblInitialize](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize.md)。請確定您傳遞的是 Partner Center 中正確的 SCID (**XBOX services** > **XBOX Settings**)。

### 隔離與共用沙箱

除非您有使用隔離沙箱的特定原因，否則請使用**共用**沙箱。您可以在 Partner Center 中檢查您的沙箱類型。隔離沙箱有額外的限制，可能會導致登入失敗。

***

## 遊戲特定的疑難排解

如果 XBOX 應用程式登入正常運作，**而且**範例專案可以使用您遊戲的識別碼運作，但您的遊戲仍然無法登入 ([診斷流程圖](#diagnostic-flowchart)的步驟 3)，問題是您遊戲的程式碼或設定所特有的。

### 比較 MicrosoftGame.config 檔案

將您遊戲的 `MicrosoftGame.config` 與可運作的範例進行差異比較。尋找多出或缺少的欄位、格式差異或不正確的值。

### 比較登入程式碼

將您遊戲的登入實作與範例的程式碼進行比較。尋找呼叫 `XUserAddAsync` 的方式 (選項、回呼、錯誤處理) 之間的差異。

### 沒有預設使用者 (0x89245106, E\_GAMEUSER\_NO\_DEFAULT\_USER)

此錯誤表示目前沒有已登入的預設使用者。

\*\*原因：\*\*您使用 `AddDefaultUserSilently` 選項呼叫了 `XUserAddAsync`，但目前沒有已登入的使用者。

**如何修正：**

如需詳細資訊，請參閱 [`XUserAddAsync`](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuseraddasync) 和 [AdvancedUserModel](https://docs.xbox.com/zh-TW/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-advancedusermodel.md)。

***

## 其他疑難排解

### XBOX 服務發生中斷

如果您已用盡所有其他選項，請檢查 XBOX 服務是否發生中斷：

* [XBOX 狀態頁面](https://support.xbox.com/xbox-live-status)

> [!IMPORTANT]
>
> \*\*已知限制 (GDK 26.04)：\*\*透過 SSH 工作階段執行時，`XblPCSandbox` 無法切換
> 沙箱。請改為從本機工作階段執行 `XblPCSandbox`。

***

## 錯誤碼快速參考

| 錯誤碼 | 名稱 | 可能的原因 | 修正方式 |
| - | - | - | - |
| `0x8015DC12` | 使用者不在沙箱中 | 識別碼不相符、沒有沙箱存取權、測試帳戶對沙箱的存取權已到期，或隔離沙箱 | 請參閱[檢查清單](#preflight-checklist)；確認識別碼、帳戶存取權和沙箱類型 |
| `0x87dd0005` | `AM_E_XAST_UNEXPECTED` | 未在 Partner Center 中啟用 PC 平台 | 在 XBOX Settings 中啟用 **Windows 10 (及更新版本) PC**、**發佈**至沙箱，然後等待 30 分鐘 |
| `0x89245106` | `E_GAMEUSER_NO_DEFAULT_USER` | 沒有已登入的預設使用者；呼叫了 `XUserAddAsync(AddDefaultUserSilently)` | 如需如何解決此問題的詳細資訊，請參閱 [`XUserAddAsync`](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuseraddasync) 和 [AdvancedUserModel](https://docs.xbox.com/zh-TW/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-advancedusermodel.md)。 |
| `0x803F8001` | 授權錯誤 | 先前未曾在 RETAIL 中啟動 XBOX 應用程式 | 切換至 RETAIL、啟動 XBOX 應用程式，然後切換回開發沙箱 |
| `0x80004005` | 一般登入失敗 | 沙箱或帳戶設定錯誤；也可能表示服務端問題 | 完成[預檢檢查清單](#preflight-checklist)；確認沙箱識別碼、測試帳戶存取權和帳戶到期日。如果問題持續發生，請嘗試重新啟動 PC 並重新切換沙箱。 |

> [!NOTE]
>
> 如果您看到此處未列出的錯誤碼，請透過意見反應中樞提交問題。
>
> 使用 xblPcSandbox /feedback 提交錯誤
>
> 或者，如果直接從意見反應中樞提交，請選擇 **Category: Gaming and XBOX** 和 **Area: Developer Tools**

***

## 另請參閱

* [沙箱概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
* [進階沙箱概念概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
* [測試帳戶](https://docs.xbox.com/zh-TW/services/xbox-services/develop/test-accounts/live-test-accounts.md)
* [XBOX 服務設定概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)
* [MicrosoftGame.config 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md)
* [XblPCSandbox.exe 參考](https://docs.xbox.com/zh-TW/tools/tools-services/live-pc-sandbox-switcher.md)


## Related topics

- [Xbox 服務沙箱概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [疑難排解](https://docs.xbox.com/zh-TW/services/xbox-services/develop/troubleshooting/index.md)
- [PC 的 Unreal 開發：開始使用 (舊版)](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unreal/unreal-legacy.md)
- [正確切換沙箱以進行市集作業](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-switching-sandbox.md)
- [針對 XBOX 服務登入進行疑難排解](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md)