白屏修复：本地端口被占用的解决方法
症状描述
启动 AlgerMusicPlayer 后：
- 主窗口只有空白，没有任何内容
- 底部无播放控制
- 托盘图标正常但应用不可用
最常见原因：端口被占用
AlgerMusicPlayer 启动时会在本机启动 netease-cloud-music-api 本地服务，需要绑定一个本地端口。如果该端口已经被其他程序占用，服务启动失败 → 前端没有数据源 → 白屏。
检查占用进程
Windows：
CMD 中执行：
netstat -ano | findstr :<端口号>
tasklist | findstr <PID>macOS / Linux：
lsof -i :<端口号>解决方法
方案一：在设置里换端口
如果主窗口虽然白屏但设置还能打开（托盘右键 → 设置）：
- 设置 → 通用 → 本地服务端口
- 改成一个不常用的端口号（如 30010、50231 这样的高位随机数）
- 重启应用
方案二：修改配置文件
如果白屏导致无法打开设置：
找到 AlgerMusicPlayer 的配置文件（通常在 Electron 用户数据目录下），手动修改端口值后重启。
方案三：清理占用进程
如果知道是什么程序占了端口（比如另一个音乐播放器、代理工具、开发服务器），关闭它再启动 AlgerMusicPlayer。
其他白屏原因
| 原因 | 排查 | 解决 |
|---|---|---|
| 端口被占用（最常见） | netstat / lsof 检查 | 换端口 |
| 服务器暂时挂掉 | 其他客户端也用不了 | 等恢复 |
| 安卓不支持版本 | Android 版本过低 | 升级系统或换设备 |
| Chromium 内核问题 | electron-updater 自动更新后出现 | 手动下载最新版覆盖安装 |
| 公司/校园网络限制 | 换个网络试试 | 检查防火墙/代理设置 |
仍未解决？
按顺序尝试：
- 完全卸载 AlgerMusicPlayer（删除用户数据目录）→ 重新安装
- 在全新的 WiFi 网络下尝试（排除公司/校园网限制）
- GitHub Issues 搜索是否有类似问题
- 微信公众号「AlgerMusic」反馈