import{_ as i}from"./plugin-vue_export-helper-x3n3nnut.js";import{r as l,o as s,c as r,a as e,b as o,d as t,e as a}from"./app-IvOzM4sf.js";const d={},c=e("h1",{id:"常见的程序异常",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#常见的程序异常","aria-hidden":"true"},"#"),o(" 常见的程序异常")],-1),p=e("p",null,[o("该文档包含由"),e("strong",null,"用户端错误"),o("造成的问题")],-1),h=e("h2",{id:"runtimeenvironmentexception",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#runtimeenvironmentexception","aria-hidden":"true"},"#"),o(" RuntimeEnvironmentException")],-1),u=e("li",null,[o("异常："),e("code",null,"RuntimeEnvironmentException"),e("ul",null,[e("li",null,[o("提示："),e("code",null,"未开启长路径功能，无法设置注册表键值")])])],-1),_=e("li",null,"问题来源：没有解除 Windows 目录长度限制",-1),g={href:"https://d.hut.ao/d/tools/EnableLongPaths.zip",target:"_blank",rel:"noopener noreferrer"},f=e("code",null,".reg",-1),b=a('<h2 id="return-code-10001" tabindex="-1"><a class="header-anchor" href="#return-code-10001" aria-hidden="true">#</a> Return Code: -10001</h2><ul><li>该异常实际上来源于米游社的返回信息，包括： <ul><li><code>Return Code: -10001</code></li><li><code>Return Code: -100</code></li></ul></li><li>问题来源： <ol><li>Cookie 过期或网络异常</li><li>系统时间错误</li></ol></li><li>解决方案： <ol><li>在帐号面板中，点击<code>刷新 Cookie</code></li><li>删除帐号后重新添加米游社帐号</li><li>在系统设置中启用自动同步时间并立刻同步时间</li></ol></li></ul><h2 id="状态-1034-验证失败" tabindex="-1"><a class="header-anchor" href="#状态-1034-验证失败" aria-hidden="true">#</a> 状态：1034 验证失败</h2><ul><li>当胡桃工具箱返回 <code>1034</code> 状态码并提示验证失败时（通常是实时便笺功能），代表当前的操作被米游社的验证系统所阻挡</li><li>解决方式： <ul><li>进入 <code>实时便笺</code> 功能</li><li>点击右上角的 <code>验证当前用户与角色</code>按钮</li><li>根据米游社提示进行验证</li><li>完成验证后点击<code>完成</code></li><li>此时，风控应当已被解除；若没有，可继续执行上述操作</li></ul></li></ul><div class="hint-container tip"><p class="hint-container-title">提示</p><ul><li>若风险提示过于频繁，或始终无法触发验证，代表您的账号风险已过高，请修改密码，使多个设备同时登录的状态被重置</li></ul></div><div class="hint-container warning"><p class="hint-container-title">注意</p><ul><li>若您<strong>已绑定并使用可提供原神查询的 Bot</strong>或<strong>同时有多个设备使用同一个米哈游通行证</strong>，则本条目所示的情况，尤其<strong>无感验证</strong>将基本无法成功，这是米游社后端的<strong>安全性</strong>设计，不可避免，无法绕过</li><li>若您本地有多个<strong>米哈游通行证</strong>同时频繁与<strong>米游社</strong>进行数据交互，则可能会被米游社在一定时间内封禁 IP 地址，这是米游社后端的<strong>安全性</strong>设计，不可避免，无法绕过</li></ul></div><h2 id="httprequestexception-元数据校验文件下载失败" tabindex="-1"><a class="header-anchor" href="#httprequestexception-元数据校验文件下载失败" aria-hidden="true">#</a> HttpRequestException 元数据校验文件下载失败</h2><h3 id="_403-forbidden-404-not-found" tabindex="-1"><a class="header-anchor" href="#_403-forbidden-404-not-found" aria-hidden="true">#</a> 403 (Forbidden)/ 404 (NOT FOUND)</h3>',8),m={href:"https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52",target:"_blank",rel:"noopener noreferrer"},k=e("h3",{id:"_502-bad-gateway",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#_502-bad-gateway","aria-hidden":"true"},"#"),o(" 502 (Bad Gateway)")],-1),x={href:"https://github.com/DGP-Studio/Snap.Hutao/issues/100",target:"_blank",rel:"noopener noreferrer"},w=e("p",null,[o("当胡桃工具箱无法从远程服务器获取到必要资源时（通常是配置文件和图片缓存），会在用户界面抛出如下图所示的 "),e("code",null,"HttpRequestException"),o(" 错误。")],-1),v=e("p",null,[e("img",{src:"https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Tb2RUm1g6du5YeNuy_!!1797064093.jpg_.webp",alt:"HttpRequestException",loading:"lazy"})],-1),C=e("p",null,"当你遇到该情况，且已经确定本地网络没有互联网连接问题时，请检查是否启用了系统代理程序。如果是，请关闭。胡桃工具箱的远程服务器在全世界范围内都有类似的体验效果， 你无需为了胡桃工具箱的网络连接而使用代理网络。",-1),E={href:"https://www.telerik.com/fiddler/add-ons",target:"_blank",rel:"noopener noreferrer"},N={href:"https://learn.microsoft.com/zh-CN/windows/iot-core/develop-your-app/loopback",target:"_blank",rel:"noopener noreferrer"},R=a(`<p>你亦可以执行下面的 PowerShell 脚本以解除本机所有容器化应用的 Loopback 限制</p><div class="language-powershell line-numbers-mode" data-ext="powershell"><pre class="language-powershell"><code><span class="token keyword">FOR</span> <span class="token operator">/</span>F <span class="token string">&quot;tokens=11 delims=\\&quot;</span> <span class="token operator">%</span>p IN <span class="token punctuation">(</span><span class="token string">&#39;REG QUERY &quot;HKCU\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\CurrentVersion\\AppContainer\\Mappings&quot;&#39;</span><span class="token punctuation">)</span> <span class="token keyword">DO</span> CheckNetIsolation<span class="token punctuation">.</span>exe LoopbackExempt <span class="token operator">-</span>a <span class="token operator">-</span>p=<span class="token operator">%</span>p
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div></div></div><h2 id="_653366069-请求异常" tabindex="-1"><a class="header-anchor" href="#_653366069-请求异常" aria-hidden="true">#</a> <code>653366069</code> 请求异常</h2><ul><li>网络请求错误，请求异常前程序会说明具体哪一个功能的网络请求失败。 <ul><li>如果仅是偶尔出现的问题，你可以考虑忽略该错误</li><li>如果持续该错误，请检查本地网络到目标服务器的连接是否正常</li></ul></li></ul><h2 id="在查找必要的模块时出现问题" tabindex="-1"><a class="header-anchor" href="#在查找必要的模块时出现问题" aria-hidden="true">#</a> 在查找必要的模块时出现问题</h2><p>当用户在解锁游戏帧数限制的情况下启动游戏时，可能会遇上以下错误提示并启动游戏失败</p><ol><li>在查找必要的模块时遇到问题：无法读取任何模块，可能是保护驱动已经加载完成</li><li>在查找必要的模块时遇到问题：查找模块超时 该问题仅当原神反作弊模块早于解锁帧率模块启动时出现。在出现该错误后，胡桃会主动关闭游戏进程，用户再次尝试启动游戏即可。</li></ol><h2 id="应用安装失败-错误消息-出现内部错误-0x80073d05" tabindex="-1"><a class="header-anchor" href="#应用安装失败-错误消息-出现内部错误-0x80073d05" aria-hidden="true">#</a> 应用安装失败，错误消息：出现内部错误 0x80073D05</h2><p>安装时出现 <code>0x80073D05</code> 错误码的主要原因是先前卸载时没有删除部分本地文件导致的。</p><ul><li>需要打开 <code>%appdata%/../Local/Packages</code></li><li>并在文件夹中找到 <code>60568DGPStudio.SnapHutao_ebfp3nyc27j86</code> 文件夹并删除</li></ul>`,10);function P(S,q){const n=l("ExternalLinkIcon");return s(),r("div",null,[c,p,h,e("ul",null,[u,_,e("li",null,[o("解决方案：下载 "),e("a",g,[o("EnableLongPaths.zip"),t(n)]),o(" 后解压，运行解压后的 "),f,o(" 文件")])]),b,e("p",null,[o("解决方案：更新胡桃工具箱至"),e("a",m,[o("最新版本"),t(n)])]),k,e("blockquote",null,[e("p",null,[o("相关 Issue: "),e("a",x,[o("https://github.com/DGP-Studio/Snap.Hutao/issues/100"),t(n)])])]),w,v,C,e("p",null,[o("如果系统代理是你的网络必须选项，请关闭系统代理而使用 TUN 模式代理；或者也可以通过 "),e("a",E,[o("Windows 8 AppContainer Loopback Utility"),t(n)]),o(" 解除 "),e("a",N,[o("Windows APP Container Loopback 的限制"),t(n)]),o(" 。")]),R])}const H=i(d,[["render",P],["__file","exceptions.html.vue"]]);export{H as default};