故障排查
遇到问题时，先记录页面、账号类型、当前版本、发生时间和完整错误消息，再按下面的顺序处理。
Web 无法打开
- 确认浏览器可以打开其他 HTTPS 网站。
- 检查电脑时间是否自动同步。
- 换用最新版 Chrome、Edge 或移动端系统浏览器。
- 临时关闭会拦截脚本或跨站请求的浏览器扩展。
- 仍然失败时记录错误页面，不要反复刷新提交表单。
二维码无法识别
- 重新截图，保证二维码完整、清晰、无遮挡；
- 直接复制文本粘贴，不要手动改动字符；
- 临时访问码过期后重新生成；
- 确认当前登录的账号是目标账号。
如果二维码能被网页生成但机台提示访问错误，先验证 Token、重新生成一次性码，再确认机台的访问码设置已保存并按要求重启。临时码与长期码的生命周期不同，不能只测试其中一种。
Token 无效或登录中止
重新打开账号选择页并验证 Token。如果二维码和密码都失败，联系管理员确认账号状态；不要在公共设备上保存新的凭据。
配方读取为空
先确认登录的是正确账号，再让对应账号完成一次正常连接，然后点击重新加载。机台级项目只会对有权限的机台账号显示。
机台无法连接
- 检查电源、网线和路由器。
- 确认安装版本与当前更新通道匹配。
- 等待网络恢复后只重启一次。
- 若仍失败，保留状态图标、时间和版本，联系管理员。
如果两台机台只有一台能连接或只有一台看到更新，逐项比较连接目标、分支、订单选择、磁盘空间和最后上报时间。一次只修改一台机台的一个条件。
如果机台没有 DHCP 地址，先检查指定 LAN 口、网线、路由器 DHCP 和地址池，再检查服务连接；不要先改网页配方。若每天固定时间短暂掉线，先等待维护窗口结束，超过窗口仍未恢复才继续排查。
更新后缺少内容
大型更新可能拆分下载。先查看下载进度是否已经完成，再重启应用。若进度长时间不动，保存日志和画面，等待管理员判断是否需要恢复。
屏幕版本号不变不一定表示更新失败；先确认所有安装项、发布时间、可选列表和侧载选择。更新期间不要删除下载缓存，也不要重复创建同名订单。
缓存恢复失败
- 确认文件是有效 JSON，且来自同一账号；
- 不要用文本编辑器改动备份结构；
- 先下载当前状态再重试；
- 恢复后重新加载记录和成绩页面。
如果机台已经提示数据保存失败，先从上传缓存页面下载快照，再按页面流程上传一次。响应超时后先刷新列表，不要立即重复提交。恢复或上传后仍没有记录时，检查账号、时间范围和是否需要等待索引更新。
如果上传缓存页面暂时报错但机台数据仍在本地，先不要清理缓存；保留快照并等待服务恢复或管理员确认后再上传。清理动作不可逆，不能用来解决网络超时。
如果所有更新安装项同时出现相同错误状态，先检查自定义更新限速、网络速度、磁盘可用空间和发布时间。历史经验表明，关闭限速或恢复当前公告要求的值后才适合重新尝试；不要把旧批次的数值直接套到新版本。
账号被锁定或登录状态异常
账号被锁定、登录状态长时间为“进行中”或登录后立即失效时：
- 停止重复获取二维码和重复登录；
- 记录最后一次成功登录时间和当前提示；
- 保留网页缓存/上传缓存；
- 验证浏览器 Token，但不要把完整 Token 发给他人；
- 让管理员确认账号状态和机台连接。
长期访问码不是解锁工具，一次性码也不应在状态异常时反复尝试。
侧载/挂载问题
- 热重载开关已启用但仍提示重启：按提示执行冷重启，部分启动配置和大资源不能热应用；
- 热重载后卡在挂载、挂载后黑屏：先等待一次完整周期，记录最后上报，维护窗口内按公告冷重启一次；仍失败时进入恢复流程，不连续重放热重载；
- 禁用开机自动挂载后没有内容：在机台空闲时执行一次手动挂载，再刷新健康和订单状态；
- 安装后直接回到旧版本：确认选择的侧载项、订单是否完成、是否还有分包等待；
- 侧载内容卡顿或续关异常：记录曲目、版本、温度/散热和发生阶段，不要连续热重载；
- 侧载崩溃后自动回到主分支：先把它记录为侧载未稳定保持，回读运行分支和订单，停止继续测试触发问题的内容；
- 侧载后主分支登录或上传异常：先保留上传缓存，完成一次页面要求的切回/重启，再分别回读登录、记录、成绩和缓存；
- 只有某项音乐、谱面不一致或崩溃：优先检查该项分包、详情、分支和映射，不要复制其它机台目录覆盖；
- 侧载镜像挂载很慢：同时看订单进度、磁盘读写、网络速度和最后上报，只要在变化就等待一次完整周期；
- 网页投币成功但实体输入没反应：区分网页动作、机台状态和现场输入，查看页面提供的摄像头/输入状态，只做一次最小测试；
- 两台机台一台能上传一台不能：按网络、机台、账号三层比较同一时间点状态，一次只改变一个条件；
- 可选订单列表为空：核对可选标记、名称、黑名单、发布时间和当前分支，保存后重新打开回读；
- 命令提示权限拒绝：停止重试，联系拥有机台权限的管理员。
联系管理员时附带的信息
- 发生时间（含时区）；
- 页面或机台当前版本；
- 账号类型，不要发送完整 Token；
- 错误消息和截图（遮挡二维码、密钥、地址和个人信息）；
- 已经尝试过的步骤。