网盘挂载后不显示内容与风控报错汇总
程序本身正常、问题出在网盘接口或账号时，对照这一页。
挂载成功但目录是空的
- Terabox：网盘限制非海外 IP 访问，国内机器看不到内容属正常，需让程序流量走代理；
- 根文件夹 ID 填错：换回 root 验证一次，能出来就是 ID 问题；
- 网盘接口变更：老驱动对新接口失效，更新程序到新版再试。
令牌循环失效 / 频繁掉线
- 确认令牌来源正确：阿里云盘开放平台驱动必须用它自家工具页扫码获取的令牌，旧接口令牌不通用；
- OAuth 链接被阻断：按官方文档把 Oauth 令牌链接换成官方新地址；
- 检查部署机时间是否准确，时间偏差会导致令牌校验异常。
风控与临时封禁
| 报错 | 处理 |
|---|---|
| 123 云盘 json 反序列化报错 | 部署机 IP 被临时限制，停几小时到一天 |
| 百度 hit black userlist | 接口风控，等 24 小时多数自愈 |
| 天翼 need img validate code | 开「不使用 OCR」或自建 OCR 接口；网页登录方式变动后按官方建议改用 Cookie/客户端驱动 |
| 189 设备 ID 不存在 | 触发风控，改密码后重试 |
| Too Many Requests（阿里） | 请求频率超限，稍等再试，正常使用不受影响 |
多账号与令牌管理
缓存导致「没变化」
上传不显示、删除还在、目录结构不变：默认半小时缓存，手动刷新或调小缓存过期，见上传问题。