体检、排障与常见问题
目录
体检（doctor）
概览页与 wp sss doctor 输出同一份体检：配置完整度、匿名读可达性、签名配置、上传地址前缀等，末尾附队列状态（待传 / 失败 / 后台任务 / 运行锁）。有阻断项会明确写出修法。
常用排障入口
- 工具 → 排障 → 扫描：最近一批附件的本地缺失、访问域名不一致、http 明文、失败标记、前缀不符。
- 诊断：贴一个裂图地址，插件给出判定链（哪个环节改写了地址、对象是否在桶）。
- 抽检远端：按编号从新到旧抽最新进桶的 10 个附件做 HEAD，确认对象真的在。
- 操作记录：最近 50 条上传/失败/删除/拉回。
常见问题
前台图片 404
- 对象真的在桶里吗——用抽检远端确认
- 地址是桶域名还是本地？本地说明附件未进桶或已解除标记
- 开了签名访问？签名过期会 403/404，页面缓存要短于签名有效期
补传一直失败
- 看操作记录里的失败原因：密钥权限、本地文件缺失、文件类型被排除
- 0 字节的损坏文件也能上传（0.9.1 起），如果仍失败看具体报错
- 连续失败 3 次会退出队列，修好后用「重试失败项」
点「开始补传」立即结束
0.9.0 的一个缺陷会导致待传队列被误清空（已在 0.9.1 修复）。确认你运行的是 0.9.1 或更高版本。
删除远端时报「前缀不符」
插件的对象键带前缀保护：换了前缀后拉回/删除会拒绝操作旧前缀对象，避免写错目录。把插件前缀改回原值，或用厂商控制台处理。
边界与已知限制
- 多站点（Multisite）暂不支持，不要在网络层激活。
- COS / OBS / 七牛的超大文件上传是单请求（超时按体积放大）；百兆以上建议用 OSS / S3 兼容厂商。
- 桶内对象没有版本控制时删除不可恢复——建议在云控制台开启版本控制。