书源无法加载等问题可通过五种方法解决：一、手动更新书源文件；二、用内置浏览器预访问目标站点；三、调整书源访问参数；四、切换至“国内CDN”备用书源；五、清除APP缓存重置会话状态。
如果您在使用柚子小说阅读时发现书源无法加载、搜索失败或目录为空，则很可能是书源规则失效或网络适配异常。以下是针对该问题的多种应对方法：
本文运行环境：iPhone 15 Pro，iOS 18。
一、手动更新书源文件
书源失效常因网站结构变动导致原有规则无法解析新页面，需通过最新书源链接覆盖旧配置。官方维护者通常会在GitHub或镜像站点同步更新，用户可主动拉取最新版本。
1、打开柚子小说APP，进入「我的」→「书源管理」→ 点击右上角「+」号。
2、在「导入书源」界面，粘贴最新书源分享链接，例如：https://raw.ixnic.net/XIU2/Yuedu/master/shuyuan。
3、点击「确定」后等待校验完成，状态显示「已连接」即表示更新成功。
二、使用内置浏览器预访问目标站点
部分书源（如起点中文网）依赖Cookie验证机制，未登录状态下直接调用API会触发反爬拦截。通过内置浏览器先行访问可自动写入有效会话凭证。
1、在柚子小说中点击「发现」→「书源列表」，找到对应失效书源。
2、长按该书源条目，选择「用内置浏览器打开」。
3、在浏览器中任意浏览该网站1–2个页面，关闭浏览器后返回书源管理页重新校验。
三、调整书源访问参数降低触发限制
高频请求易被目标网站识别为爬虫行为并限流，适当降低并发与节奏可显著提升稳定性。
1、进入「我的」→「设置」→「高级设置」→「书源相关」。
2、将「搜索线程数」设为1，「预下载章节数」设为3。
3、启用「搜索间隔」选项，并设定为3秒以上。
四、切换至标注“国内CDN”的备用书源
境外服务器响应延迟或地区屏蔽会导致连接超时，优先选用经国内节点加速的书源可规避此类问题。
1、访问Yiove综合书源库或README.md第42行推荐地址，筛选含「国内CDN」标签的书源。
2、复制其Raw链接，在「书源管理」中导入并校验。
3、校验通过后，长按当前失效书籍封面，选择「更换书源」→ 选取新导入的国内CDN书源。
五、清除APP缓存重置会话状态
本地缓存中过期的Cookie或临时凭证可能干扰新版书源的正常握手流程，清除后可强制重建连接环境。
1、退出柚子小说APP，进入手机「设置」→「通用」→「iPhone存储空间」。
2、在应用列表中找到「柚子小说」，点击进入后选择「卸载App」（注意：此操作仅清除数据，不删除已下载书籍）。
3、重新安装APP后，立即导入最新书源并执行内置浏览器预访问步骤。
