safebooru 中文文档 下载 App

搜索结果全是空白:是网络问题还是被过滤光了

两种白

Safebooru 列表空白有两种完全不同的表现:

表现一:整个列表区域一片纯白,连缩略图占位都没有,也没有转圈——这就是搜索请求返回了零结果(不是加载失败)。

表现二:列表区域有灰色方块占位,但图片永远加载不出来——这是图片资源请求失败(网络问题或 CDN 问题)。

表现一:纯白 = 零结果

和 搜索结果为空排查 是同一个问题——标签条件没命中任何图。按那页的排查清单一步步缩窄条件。

表现二:灰色占位 = 图片加载失败

这种情况搜索请求其实成功了(有图的 ID 和信息),只是图片的二进制文件拉不下来。

最常见原因:booru 站 CDN 被墙

Safebooru 对接的 booru 站图片 CDN 在海外,国内直连经常被墙或超时。列表能出来但缩略图和原图拉不到。

验证方法:连 VPN 或加速器,看图片能不能出来。出来了就是网络问题。

原因二:移动网络限速

某些运营商对海外 CDN 流量有限速或 QoS 降低优先级,导致图片请求超时。Wi-Fi 下试试对比。

原因三:图片被 booru 站删除

booru 站会定期清理违规图。列表里有缩略图占位但实际文件已删,永远加载不出来。

验证方法:换一张图看看能不能加载。如果热门图(比如 hatsune_miku rating:general 第一张)也出不来,说明不是个别图的问题。

临时解决方案

方法适用场景
连 VPN / 加速器CDN 被墙,大部分图片加载不了
Wi-Fi 下刷完想要的图移动网络限速
把感兴趣的图连点进详情页缓存列表白的时候,详情页缓存可能能拉到

怎么快速确认不是 app bug

Safebooru 本身逻辑不复杂,大部分列表空白都是网络或标签问题。先排除网络和标签再怀疑 app。