06 FAQ Startup

6.1 服务启动失败

服务启动失败是最常见的问题之一。本页汇总常见原因和解决方法。

---

症状

• 初始化界面卡在 "正在初始化..."
• 初始化完成后 WebView 显示白屏
• 底部状态栏持续显示 "未连接到 API!" 但酒馆界面无法加载

---

排查步骤

1. 查看实时日志

点击右下角 "日志" 悬浮按钮，查看错误信息。

常见日志错误：

• Error: listen EADDRINUSE → 端口被占用
• Cannot find module → npm 依赖缺失
• Killed → 内存不足

2. 检查存储空间

SillyDroid 需要约 800 MB 可用空间。空间不足会导致初始化失败。

3. 重启服务

设置 → 服务 Tab → "停止服务" → "启动服务"

4. 清空数据重试

如果以上无效：

1. 先 导出数据备份
2. 设置 → 数据 Tab → "清空数据"
3. 重新启动服务
4. 导入备份数据

---

特殊场景

安装后首次启动失败

→ 卸载后重新安装 APK，确保有足够的存储空间和时间完成初始化。

更新 APK 后启动失败

→ 尝试清空数据后重启（先导出备份）。

特定机型兼容问题

→ 在 GitHub Issues 报告你的设备型号和 Android 版本。

---

仍未解决？

→ 导出日志文件，在 GitHub Issues 附上日志和详细描述。