社区手册

故障排查

约 4 分钟阅读6 个章节

5. 故障排查

返回文档导航

5.1 常见故障速查表

症状	可能原因	处理方式	相关章节
无法启动游戏	文件损坏、驱动过旧、权限不足	验证文件完整性、更新驱动、以管理员身份运行	3.1.1
登录超时	网络波动、服务器维护	检查网络、查看公告、更换节点后重试	3.1.2
帧率过低	画质设置过高、后台占用	降低画质、关闭后台程序	3.6.1
副本无法进入	等级、任务或次数未满足	查看入口条件与剩余次数	3.5.1
奖励未到账	背包已满、邮件延迟	清理背包、检查邮件	3.5.1
无法交易	等级不足、物品绑定、风控限制	查看交易限制与账号状态	3.5.3
语音无效	麦克风权限、设备冲突	检查系统权限与音频设备	3.3.2
频繁闪退	内存不足、文件损坏、兼容性问题	更新驱动、验证文件、提交日志	5.3
结构无法定位	结构 ID 错误、维度不匹配、结构未注册	核对定位命令与维度，确认是否为注册结构	11.5
钥匙无法开启宝库	钥匙与宝库对应关系待核、钥匙类型不匹配	确认钥匙来源与客户端提示，不以报告统计替代实际交互	8.4.3
附魔书等级与预期不符	随机候选、等级预算或 `uniform` 随机	查看等级判定规则，确认来源与预算	9.2

【待补充 · 数据表格 · P-038】 补充完整故障清单、已知问题编号、影响范围与临时解决方案。
填充要求：按平台与版本分类；责任人 / 目标版本：待指派 / v1.0.0

5.2 错误码说明

错误码	含义	触发场景	处理建议
HC-1001	待补充	登录验证失败	检查账号、密码与验证码
HC-1002	待补充	网络连接超时	检查网络并重试
HC-2001	待补充	副本条件未满足	查看等级、任务与次数
HC-2002	待补充	背包空间不足	清理背包后重试
HC-3001	待补充	交易限制	查看绑定状态与风控提示
HC-9001	待补充	客户端文件异常	验证游戏文件完整性

【待补充 · 数据表格 · P-039】 补全错误码、官方释义、触发条件、处理步骤与升级反馈条件。
填充要求：与客户端实际提示一致，定期校对；责任人 / 目标版本：待指派 / v1.0.0

5.3 日志收集与反馈

5.3.1 日志文件位置

平台	默认日志路径	备注
Windows	`%LOCALAPPDATA%\HotCoco\Logs`	可在启动器中选择“打开日志目录”
macOS	`~/Library/Logs/HotCoco`	通过 Finder 前往文件夹
Linux	`~/.local/share/HotCoco/logs`	以实际安装路径为准
Android	游戏内设置 → 帮助与反馈 → 导出日志	导出后通过邮件或工单提交
iOS	游戏内设置 → 帮助与反馈 → 导出日志	导出后通过邮件或工单提交

【待补充 · 数据表格 · P-040】 核实各平台日志路径、文件命名规则与导出方式。
填充要求：以客户端实际行为为准，附操作截图；责任人 / 目标版本：待指派 / v1.0.0

5.3.2 提交反馈模板

【问题反馈】
游戏版本：
平台 / 系统：
设备型号：
角色 ID：
服务器：
问题发生时间：
问题描述：
复现步骤：
1.
2.
3.
预期结果：
实际结果：
错误码：
日志文件：
截图 / 录屏：
联系方式：

【待补充 · 操作步骤 · P-041】 补充反馈入口、工单字段、附件大小限制、处理时限与进度查询方式。
填充要求：附反馈页面截图与提交成功示例；责任人 / 目标版本：待指派 / v1.0.0

提示
提交日志前请检查是否包含个人信息。如日志中包含敏感内容，请先打码或仅提供问题发生时间段。

本篇阅读完毕，继续探索吧。