> ## 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 Live 服务 API 故障排除

> 启用 XSAPI 响应日志记录和使用 HCSettingsSetTraceLevel 进行详细的调试跟踪,以诊断 XBOX Live 服务 REST 调用和 HTTP 响应失败。

仅使用来自 XBOX Live 服务 API 层的错误很难诊断故障。
可以向服务器提供额外的有用错误信息——例如所有 RESTful 调用的日志记录。

要监听这些附加数据,请挂接响应记录器并启用调试跟踪。
响应日志记录允许您查看 HTTP 流量和 Web 服务响应代码,其作用通常和 Fiddler 跟踪一样有用。

## 代码示例

以下代码示例启用响应日志记录,并将调试错误级别设置为 **Verbose**。
(您也可以将调试错误级别设置为 **Error** 以仅跟踪失败的调用;或设置为 **Off** 以禁用跟踪。)

在 Visual Studio 中运行您的项目时,生成的调试输出将发送到"输出"窗格。

**C API**

```cpp theme={null}
HCSettingsSetTraceLevel(HCTraceLevel::Verbose); // See HCTraceLevel enum for various levels
HCTraceSetTraceToDebugger(true);
```

```cpp theme={null}
void CALLBACK TraceCallback(
    _In_z_ char const* areaName,
    enum HCTraceLevel level,
    uint64_t threadId,
    uint64_t timestamp,
    _In_z_ char const* message
)
{
    // Log info
}

HCTraceSetClientCallback(TraceCallback);
```


## Related topics

- [XBOX 服务登录故障排除](/zh-CN/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md)
- [XBOX PC Remote 工具常见问题解答和故障排除指南](/zh-CN/tools/tools-pc/xbox-pc-remote-tools/faq.md)
- [故障排除](/zh-CN/services/xbox-services/develop/troubleshooting/index.md)
- [登录和沙盒错误故障排除](/zh-CN/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
- [多人游戏常见问题和故障排除](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)