客户端 · 错误代码
HOOZi 客户端疑难杂症的自助排查。按现象找到对应小节，照着做即可。第一次使用请先看新手教程。
若照做后仍未解决，联系客服时请附上本页对应小节的名称和你看到的完整报错文字（尤其是括号里的代码，如 code 16 或 license/expired），能省掉大量来回。
报错代码速查
客户端和子程序的报错都是同一个形状：一句说明 + 括号里的代码。
订阅已过期 (license/expired)·授权数据校验失败 (code 16)
把括号里那串抄下来，在下表里搜（Ctrl+F）即可，不需要先判断自己属于哪一类。代码分两种写法只是来源不同——数字来自子程序本身，带斜杠的来自服务器——查法完全一样。
| code | 含义 | 怎么办 |
|---|---|---|
| 10 | 没有通过客户端启动 | 从 HOOZi 客户端里点启动，不要直接双击子程序的 exe |
| 12 | 本机时钟确实偏差过大 | 见本机时间不对 |
| 13 | 客户端与子程序之间的通信失败 | 关闭两者，重新从客户端启动一次 |
| 14 / 15 | 授权数据格式不对，或客户端版本过旧不认服务端的新密钥 | 把客户端和子程序都更新到最新版 |
| 16 | 授权数据校验失败 | 子程序文件损坏或被改动，重新下载安装 |
| 17 | 拿到的是别的软件的授权 | 重新从客户端启动；仍然出现请联系客服 |
| 18 | 当前设备与账号绑定的设备不符 | 见换了电脑用不了——解绑前先看那一节，有两种情况解绑无效 |
| 19 | 授权数据已过期 | 多半仍是时间问题，见本机时间不对 |
| 20 | 这份授权已经用过一次 | 关掉所有子程序窗口，从客户端重新启动 |
| 21 | 检测到调试器 | 关闭正在运行的调试 / 抓包 / 逆向类工具后重试 |
| 30 | 5 分钟内没完成浏览器登录 | 重新启动子程序，在弹出的页面上尽快完成授权 |
| 31 | 授权被取消，或页面被提前关闭 | 重试一次；期间不要关闭弹出的浏览器标签 |
| 32 | 连不上服务器 | 检查网络后重试；换个网络（如手机热点）能进一步确认 |
| 33 | 该账号已绑定到另一台设备 | 先看下面这条，再考虑解绑 |
| 34 | 该账号没有这个软件的有效订阅 | 到个人中心确认订阅状态，续费或兑换卡密后重试 |
| 50 | 网络不通（DNS / 连接 / 超时） | 检查网络后重试，换个网络再试一次 |
| 51 | 请求被服务端拒绝，通常仍是本机时间偏差 | 见本机时间不对 |
| 40–44 / 52 | 加密通道异常或服务端返回了错误 | 先更新到最新版；仍然出现请联系客服并附上完整报错 |
| 1 / 2 / 99 / 100 | 程序内部出错 | 见下面这条 |
launch/blocked_by_dialog | 子程序被弹窗挡住（多为自换的 leechcore.dll 在做在线授权） | 该窗口已被提到前台，在上面完成操作即可；详见更换 leechcore.dll |
launch/child_exited | 子程序没连上客户端就自行退出 | 打开运行日志看退出码和组件清单；同上一节 |
launch/dll_not_found | 缺依赖组件，Windows 在启动前就失败 | 运行日志会点名缺哪个；自换过 DLL 的把配套文件补齐 |
launch/dll_init_failed | 某个依赖组件初始化失败 | 多为自换的 leechcore.dll 与固件 / 驱动不配套，换回或换对版本 |
launch/dll_arch_mismatch | 依赖组件位数不对（32 / 64 位混用） | 换回与子程序同位数的那一份 |
launch/child_crashed | 子程序刚启动就崩溃 | 运行日志里有退出码；重新下载安装后仍崩请联系客服 |
launch/child_no_pipe | 子程序起来了但一直没连上客户端 | 检查是否有浏览器标签在等你完成授权；详见更换 leechcore.dll |
launch/sdk_rejected | 子程序自己拒绝了本次启动 | 运行日志里的退出码就是上表中的数字码，按那一行处理 |
launch/handshake_failed | 客户端与子程序的安全握手没完成 | 重试一次；仍不行请把运行日志发给客服 |
launch/spawn_failed | 系统拒绝启动子程序 | 多为安全软件拦截或文件被占用，把安装目录加入白名单后重试 |
launch/console_hide_failed | 子程序控制台窗口无法隐藏，已中止启动 | 重试一次；反复出现请联系客服 |
api/unknown_error | 服务器返回了无法识别的错误 | 联系客服并附上完整报错 |
app_login/code_invalidapp_login/code_used | 授权码无效或已经用过 | 重新启动一次子程序，走一遍新的授权 |
app_login/device_conflict | 账号已绑定到另一台设备 | 与 code 33 同因，见下面这条 |
app_login/device_mismatch | 登录会话与本机不符（≠ 账号绑给了别人） | 不要去解绑，解绑对它无效。重新走一次浏览器登录即可 |
app_login/disabled | 站点暂时关闭了子程序登录 | 稍后重试，或看官网/论坛公告 |
app_login/risk_stepup | 触发风控，需要先验证邮箱 | 按提示完成邮箱验证后重试 |
app_modules/no_subscription | 账号没有任何有效订阅 | 兑换卡密或续费后重试 |
app_modules/rate_limit | 调用过于频繁（每分钟上限） | 等一分钟再试；持续出现说明子程序在异常重试，请联系客服 |
app_session/branch_invalid | 版本分支无效 | 更新客户端到最新版 |
app_session/hwid_changedapp_session/hwid_mismatch | 本机设备标识与账号绑定的不一致 | 见换了电脑用不了 |
app_session/no_hwid | 读不到本机设备标识 | 与 code 100 同因，见下面这条 |
app_session/software_archivedapp_session/software_disabled | 该软件已下架或已停用 | 非账号问题，留意官网 / 论坛公告 |
apps/manifest_corrupt | 服务端文件清单异常 | 联系客服并说明是哪个软件、哪个版本 |
apps/no_release | 这条版本线还没有已发布的版本 | 在客户端里换一条版本线，或等待发布 |
apps/pack_unavailable | 安装包暂时不可用 | 稍后重试；持续出现请联系客服 |
auth/banned | 账号已被封禁 | 联系客服 |
auth/device_locked | 账号已绑定到另一台设备 | 见换了电脑用不了 |
auth/device_mismatch | 本机与登录时绑定的设备不符 | 见换了电脑用不了 |
auth/session_expired | 登录状态已过期 | 在客户端里重新登录一次 |
enc/stale | 本机时间与服务器相差过大 | 见本机时间不对。这是最常见的一条，且完全可以自己解决 |
其它 enc/… | 加密通道异常（多为客户端过旧） | 先更新客户端；仍然出现请联系客服并附上完整报错 |
license/expired | 订阅已到期 | 续费或兑换新卡密后重试 |
license/frozen | 订阅被冻结 | 联系客服了解冻结原因 |
license/none | 该软件没有有效订阅 | 先在个人中心兑换卡密 |
license/revoked | 订阅已被撤销 | 联系客服 |
net/request_failed | 连不上服务器 | 见提示无法连接服务 |
没在表里的代码，按最后一节的格式联系客服即可——报错里那串代码本身就是最有用的线索，务必原样附上。
关于「请通过启动器打开本程序」
这句提示对应 code 10。如果你确实是从客户端点的启动却仍看到它，多半是子程序版本过旧，重新下载最新版即可。
旧版本还可能报 code 11（「父进程不是启动器」）。这条判定已经取消，新版不会再出现——看到它就说明该更新了。
先确认浏览器登录的是哪个账号
解绑之前先看这一条
授权页是拿浏览器当前登录的账号来签发的。如果浏览器里登的是你的另一个账号，那么无论解绑多少次都不会好——你解的是 A 号，绑的是 B 号。
授权页上会显示「将以此账号授权」和邮箱，授权前先核对一眼；不对就点页面上的「切换账号」。
确认账号无误后仍报 33，才是真的绑在别的机器上：到 hoozi.cc/me/account 解绑，再重试。
device_conflict 与 device_mismatch 是两回事
两个都带「device」，处置方式却相反：
app_login/device_conflict（与code 33同因）= 账号绑在别的机器上 → 解绑有用app_login/device_mismatch= 本次登录会话与本机对不上，跟账号绑给谁无关 → 解绑没用，重新登录一次就好
把后者当前者处理，是解一百次也不会好的那种情况。
需要联系客服的内部错误
1 / 2 / 99 / 100 表示程序内部出错，没有自助处理办法。其中 100（以及 app_session/no_hwid）最常见的成因是本机硬件信息读取失败——若你正在使用虚拟机、精简版系统或改过 BIOS 信息，请一并说明。
联系客服时附上完整报错文字和这一节的名称即可。
客户端被其他程序替换
若出现这些现象，说明你机器上的客户端文件可能已被第三方程序改动过：
- 客户端明明装好了，启动后行为异常，或子程序反复报错
- 安装目录里的
hclient.exe属性中，产品名称不是 HClient、版权不是 HOOZi
怎么自查：找到安装目录里的 hclient.exe，右键 → 属性 → 详细信息，核对三项：
| 项 | 正常值 |
|---|---|
| 产品名称 | HClient |
| 版权 | © HOOZi |
| 产品版本 | 与客户端「关于」页显示的版本一致 |
任意一项对不上，不要继续使用。请：
- 从控制面板卸载客户端
- 用杀毒软件全盘扫描
- 只从官网重新下载安装
请勿从第三方渠道下载
非官网来源的安装包（网盘转发、群文件、「绿色版」「免登录版」）是这类问题最常见的来源。客户端安装包只从官网获取。
本机时间不对
客户端和子程序会校验本机时间，偏差超过 5 分钟就会拒绝启动（code 12）。
Windows 设置 → 时间和语言 → 日期和时间 → 打开「自动设置时间」，再点一次「立即同步」。同时确认时区设置正确——时区错了，即使显示的时间看着对，实际也是偏的。
如果你确信系统时间是对的，却仍然收到
code 12：请更新到最新版子程序。旧版在校时服务器连不上时（部分公司网 / 校园网 / 酒店 WiFi 会封校时端口）会误报成时间错误，重开一次往往又好了——这个误报已在新版修复，连不上校时服务器不再阻止启动。
换了电脑用不了
账号绑定单台设备。换机、重装系统、更换主板都会让设备标识改变，此时启动会提示设备不符（code 18）或已绑定到另一台设备（code 33）。
到 hoozi.cc/me/account 执行设备解绑，即可在新设备上重新绑定。解绑规则（次数、冷却时间）以你所持卡密类型为准，页面上有说明。
解绑前先确认三件事
一、你登录的是哪个账号。 多账号用户最容易踩这个坑：解绑的是 A 号，而子程序授权时用的是浏览器里登录的 B 号。这种情况下解绑一百次都没用。
二、「设备解绑」不是「卡密解绑」。 个人中心里这是两个不同的功能——卡密解绑会退卡并生成新卡，不解除设备绑定。要换机器用的是设备解绑。
三、报错里说「版本不一致」或「读取失败」的，解绑无效。 前者把客户端和子程序都更新到最新版；后者见需要联系客服的内部错误。只有报错附的两串设备码明显不同，才是真的换了设备。
提示无法连接服务
先确认不是本地网络问题：换一个网络（例如手机热点）再试一次。
若换网络仍然连不上，多为服务端侧的临时状况，稍后重试即可，无需重装客户端或重新兑换卡密。
还没有覆盖到你的问题？
本手册会持续补充。遇到这里没写到的情况，请联系客服并描述：你做了什么操作 → 期望发生什么 → 实际发生了什么，附上完整报错截图。