Files
Snap.Hutao.Docs/docs/zh/advanced/exceptions.md
Mikachu2333 b8ceb907c7 QA Update (#133)
* 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>
2024-06-29 00:18:14 -07:00

4.9 KiB
Raw Blame History

headerDepth, icon, category, order, comment, description, banner
headerDepth icon category order comment description banner
2 iconfont icon-warn
FAQ
2 false 胡桃工具箱会使用特定的错误代码指示特定的错误,如果你在使用过程中遭遇了程序错误并且有一个错误代码,你可以尝试在该页查询。 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 限制

403 (Forbidden)/ 404 (NOT FOUND)

解决方案:更新胡桃工具箱至最新版本

502 (Bad Gateway)

连接到胡桃服务器时失败,请检查胡桃客户端的网络连接

653366069 请求异常

  • 连接到 米游社 / HoYoLAB 服务器时失败
    • 如果仅是偶尔出现的问题,你可以考虑忽略该错误
    • 如果持续该错误,请检查本地网络到目标服务器的连接是否正常

如果你使用了网络代理,请务必检查是否解除了 Windows 容器 Loopback 限制

资源下载失败

一小部分的静态资源的下载失败不会明显导致 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 解决,详情请百度)