Olib 搜索返回空结果 — 搜不到书的排查方法
现象一：搜索一直转圈
输入关键词后点搜索，界面一直转圈没有结果返回。
排查步骤
- 检查线路 — 当前线路可能不通。切到其他线路或自定义线路再搜。
- 刷新界面 — 关闭搜索结果页面，回到主界面重新搜索。
- 重新登录 — 退出当前账号再重新登录。
现象二：完全没有结果
转圈停了但结果列表为空。
排查步骤
可能是关键词问题
| 关键词问题 | 解决方法 |
|---|---|
| 书名太冷门 | 换更热门的书先试试是不是通用问题 |
| 书名有错别字 | 回搜一遍核对拼写 |
| 用了副标题 | 去掉副标题只用主书名 |
| 用了简称 | 试试全称（比如搜「红楼梦」而不是「红楼」） |
| 中文书名 | Z-Library 是国际站，试试英文译名或拼音 |
可能是账号问题
- 确认当前 Z-Library 账号还有效（可以去浏览器里登 Z-Library 网站验证）
- 确认账号没有被风控或限制
可能是线路问题
- 切换其他线路试试
- 线路可能只支持登录但不支持搜索 API（较少见，但可能）
现象三：结果里没有你想找的书
搜「围城」出来一堆相关书，但没有钱锺书的原版《围城》。
可能原因：
- Z-Library 上确实没收录这本书的某个特定版本
- 书名写法有差异（比如「围城」和「围城 (精装版)」会被认为不同条目）
- 试试用 ISBN 搜索，精准定位
试试这个
一个好的测试关键词是《三体》——这是 Z-Library 上非常热门的中文科幻小说，应该能搜到几十条结果。如果搜《三体》也搜不到，说明不是书名的问题，而是线路或账号的问题。
还是搜不到
- 换时间再试 — Z-Library 后端可能临时有问题
- 更新 Olib 版本 — 新版本可能修复了搜索相关 Bug
- 用浏览器直接搜 — 打开你找到的 Z-Library 镜像域名，在浏览器里搜同一本书。浏览器能搜到但 Olib 搜不到，说明是 Olib 的问题；浏览器也搜不到，说明 Z-Library 那边确实没有这本书