mirror of
https://jihulab.com/DGP-Studio/Snap.Hutao.Docs.git
synced 2025-11-19 21:16:31 +08:00
b8ceb907c7
* update * win10 uninstall * add notes about root * format * modify * update * Update FAQ.md * Update navbar * Update docs * Update Gacha-system-and-export-principal.md * correct * update * disambig * update * add warning for auto-start (need re-update) * update * add a tabular for showing differences in each way for sync * center tabular * switch to md format * update vs * add some * RE-update tabualr * update * correct * update * move web login to the end * Update game-launcher.md * Update docs * Update character-data.md --------- Co-authored-by: LinkChou <linkchou@yandex.com> Co-authored-by: Masterain <i@irain.in>
110 lines
4.9 KiB
Markdown
110 lines
4.9 KiB
Markdown
---
|
||
headerDepth: 2
|
||
icon: iconfont icon-warn
|
||
category: [FAQ]
|
||
order: 2
|
||
comment: false
|
||
description: 胡桃工具箱会使用特定的错误代码指示特定的错误，如果你在使用过程中遭遇了程序错误并且有一个错误代码，你可以尝试在该页查询。
|
||
banner: https://opengraph.snapgenshin.cn/generate?url=https://hut.ao/zh/advanced/exceptions.html&has_description=False
|
||
---
|
||
|
||
# 常见的程序异常
|
||
|
||
该文档包含由**用户端错误**造成的问题
|
||
|
||
## Return Code: 2002
|
||
|
||
- 该异常实际上来源于米游社的返回信息: `Ruturn Code: 2002`
|
||
- 问题来源：
|
||
- 米哈游论坛账号未初始化
|
||
- 解决方案：
|
||
- 米游社账号：使用米游社官方手机应用登录账号并设置社区用户名以初始化账号
|
||
- HoYoLAB 账号：使用 HoYoLAB 官方手机应用或网页版登录账号并设置社区用户名以初始化账号
|
||
|
||
## Return Code: -10001
|
||
|
||
- 该异常实际上来源于米游社的返回信息，包括：
|
||
- `Return Code: -10001`
|
||
- `Return Code: -100`
|
||
- 问题来源：
|
||
1. Cookie 过期或网络异常
|
||
2. 系统时间错误
|
||
- 解决方案：
|
||
1. 在账号面板中，点击“刷新 Cookie”
|
||
2. 删除账号后重新添加米游社账号
|
||
3. 在系统设置中启用自动同步时间并立刻同步时间
|
||
|
||
## 状态：1034 验证失败
|
||
|
||
- 当胡桃工具箱返回 `1034` 状态码并提示验证失败时（通常是实时便笺功能），代表当前的操作被米游社的验证系统所阻挡
|
||
- 解决方式：
|
||
- 进入“实时便笺”功能
|
||
- 点击右上角的“验证当前用户与角色”按钮
|
||
- 根据米游社提示进行验证
|
||
- 完成验证后点击“完成”
|
||
- 此时，风控应当已被解除；若没有，可重复执行上述操作
|
||
|
||
::: tip
|
||
|
||
- 若风险提示过于频繁，或始终无法触发验证，代表您的账号风险已过高，请修改密码，使多个设备同时登录的状态被重置
|
||
|
||
:::
|
||
|
||
::: warning
|
||
|
||
- 若您**已绑定并使用可提供原神查询的 Bot**或**同时有多个设备使用同一个米哈游通行证**，则本条目所示的情况，尤其**无感验证**将基本无法成功，这是米游社后端的**安全性**设计，不可避免，无法绕过
|
||
- 若您本地有多个**米哈游通行证**同时频繁与**米游社**进行数据交互，则可能会被米游社在一定时间内封禁 IP 地址，这是米游社后端的**安全性**设计，不可避免，无法绕过
|
||
|
||
:::
|
||
|
||
## HttpRequestException 元数据校验文件下载失败
|
||
|
||
### ConnectionError
|
||
|
||
连接到胡桃服务器时失败，请检查胡桃客户端的网络连接
|
||
|
||
如果你使用了网络代理（包括由加速器创建的网络代理），请务必检查是否[解除了 Windows 容器 Loopback 限制](FAQ.md#如何通过网络代理使用胡桃工具箱)
|
||
|
||
### 403 (Forbidden)/ 404 (NOT FOUND)
|
||
|
||
解决方案：更新胡桃工具箱至[最新版本](../quick-start.md#全新安装)
|
||
|
||
### 502 (Bad Gateway)
|
||
|
||
连接到胡桃服务器时失败，请检查胡桃客户端的网络连接
|
||
|
||
## `653366069` 请求异常
|
||
|
||
- 连接到 米游社 / HoYoLAB 服务器时失败
|
||
- 如果仅是偶尔出现的问题，你可以考虑忽略该错误
|
||
- 如果持续该错误，请检查本地网络到目标服务器的连接是否正常
|
||
|
||
如果你使用了网络代理，请务必检查是否[解除了 Windows 容器 Loopback 限制](FAQ.md#如何通过网络代理使用胡桃工具箱)
|
||
|
||
## 资源下载失败
|
||
|
||
一小部分的静态资源的下载失败不会明显导致 Snap Hutao 的体验变差，客户端会在需要时自动重新下载缺失的图片资源。
|
||
|
||
### `Received an unexpected EOF or 0 bytes from the transport stream.`
|
||
|
||
可能因触发了下载量限制或网络波动等多因素引发。您可以关闭胡桃后稍等片刻再尝试下载，也可以尝试切换网络（例如将校园网更换为其他网络）
|
||
|
||
### 响应内容不是有效的文件字节流
|
||
|
||
可能因触发了下载量限制或网络波动等多因素引发。您可以关闭胡桃后稍等片刻再尝试下载，也可以尝试切换网络（例如将校园网更换为其他网络）
|
||
|
||
## 在查找必要的模块时出现问题
|
||
|
||
当用户在解锁游戏帧数限制的情况下启动游戏时，可能会遇上以下错误提示并启动游戏失败
|
||
|
||
1. 在查找必要的模块时遇到问题：无法读取任何模块，可能是保护驱动已经加载完成
|
||
2. 在查找必要的模块时遇到问题：查找模块超时
|
||
该问题仅当原神反作弊模块早于解锁帧率模块启动时出现。在出现该错误后，胡桃会主动关闭游戏进程，用户再次尝试启动游戏即可。
|
||
|
||
## 应用安装失败，错误消息：出现内部错误 0x80073D05
|
||
|
||
安装时出现 `0x80073D05` 错误码的主要原因是先前卸载时没有删除部分本地文件导致的。
|
||
|
||
- 需要打开 `%appdata%/../Local/Packages`
|
||
- 并在文件夹中找到 `60568DGPStudio.SnapHutao_wbnnev551gwxy` 文件夹并删除（如果权限不足请考虑使用 `NSudo_LG` 解决，详情请百度）
|