登录页扫码不显示：二维码加载失败怎么办

现象

打开 AlgerMusicPlayer 登录页，应该显示网易云二维码的区域：

• 完全空白
• 显示破损的图片
• 一直在加载转圈
• 显示一个红色 × 或破图图标

排查流程

第一步：确认网络

二维码是 AlgerMusicPlayer 从网易云接口实时拉取的。打开浏览器访问 music.163.com 看看网易云能不能正常打开。打不开的话先解决网络问题。

第二步：清浏览器缓存思路类比

虽然 Alger 不是浏览器，但原理类似——缓存了坏的图片。

快速修复：

1. 完全关闭 AlgerMusicPlayer
2. 等 5 秒
3. 重新打开

第三步：检查本地服务

AlgerMusicPlayer 登录依赖本地服务进程。如果本地服务没启动，二维码接口也拿不到。

设置 → 关于 页面看服务状态（部分版本会显示本地服务端口和状态）。如果显示未启动：

• 完全退出 Alger
• 检查端口是否被占用（netstat -ano | findstr <端口号>）
• 检查防火墙是否拦截
• 重启 Alger

第四步：换网络测试

如果公司 / 校园网络屏蔽了网易云接口：

• 手机开热点给电脑连 → 重试
• 成功说明是网络问题，和 IT 沟通或用代理

第五步：用账号密码登录绕过

如果二维码一直出不来，可以用账号密码登录方式绕过：

• 登录页切换到账号密码输入模式
• 输入手机号 + 密码登录
• 可能触发短信验证码

登录成功后功能完全一致，扫码只是更方便的方式，不是必须的。

第六步：版本更新

v5.1.0 修复了登录页一些底层问题。如果你的版本低于 v5.1.0，建议升级后重试。

登录相关的 v5.1.0 修复