常见错误

遇到错误很让人沮丧，但大多数问题都有直接的解决办法。这篇指南介绍你最可能遇到的错误以及如何修复。

Fetchii 中的错误提示

下载失败时，那一行会变红并显示一条简短信息，比如“需要登录”或“网络错误”。把鼠标悬停在这一行上可以看到具体发生了什么。这一行上会一直显示一个恢复按钮：重试，或者在登录可能有帮助时显示 处理…。

想了解完整情况，选中这个下载并打开检查器（⌘I 或工具栏按钮）。它会解释错误和下一步可以做什么，并提供 重试下载、复制错误、反馈此问题… 和 查看错误日志。这一行的右键菜单里也有同样的操作。

Fetchii 能识别常见原因，并用易懂的话告诉你：

• 需要登录、年龄限制 和 或需登录——处理… 按钮会提供登录相关的选项
• 私密——内容是私密的，只有所有者能分享给你
• 网络错误、超时 和 代理连不上——连接问题，通常检查网络后重试就能解决
• 地区限制、已删除、频率限制、磁盘已满 等——见下文

Fetchii 识别不了的错误会显示“下载失败”。下载引擎的原始信息不会显示在列表里，但 复制错误 和 查看错误日志 能给你完整的技术文本。

下载错误

“已删除”

这通常意味着视频已经不存在了——被删除、设为私密，或者链接有误。如果链接根本不指向视频，会显示“无视频”或“不支持”。

先检查链接。复制粘贴出错很常见，少一个字符就可能出问题。在浏览器里打开链接，看视频能不能播放。如果浏览器里能看但 Fetchii 不行，那是别的问题。如果哪里都打不开，那视频确实不可用了。

“需要登录”

视频存在，但你需要登录才能观看。私密视频、会员专属内容和年龄限制内容都会这样。

解决办法是让 Fetchii 能用上你的登录状态。最简单的方式是通过浏览器扩展——在登录状态下打开视频，右键选择 使用 Fetchii 下载，你的 Cookie 会随请求自动发送。对于已经失败的下载，点这一行上的 处理…，选择 使用扩展重试，或者在同一个面板里用 Firefox 或 Chrome 的 Cookie 重试。

详细说明请看 Cookie 认证指南。

“地区限制”

视频在你所在的国家或地区被屏蔽了。这是根据你的 IP 地址判断的，登录也没用——这个内容在你所在的地方就是不可用。

使用位于允许地区的代理或 VPN 可以绕过这个限制。在 设置 → 网络 → 代理 中配置代理，或者使用把所有流量都转到另一个国家的 VPN。请记住，地区限制通常是出于版权许可原因，请考虑绕过它是否合适。

“年龄限制”

和需要登录类似，但专门涉及年龄验证。网站要求证明你已达到观看该内容的年龄。

先在网站本身（浏览器里）完成年龄验证，然后点 处理…，用扩展或浏览器的 Cookie 重试。验证状态跟着你的登录会话走，所以验证后应该就能下载了。

画质不是你想要的

不是每个视频都有所有分辨率。Fetchii 的画质选项是上限——“最高 1080p”会选 1080p 以内最好的版本——所以即使没有完全对应的画质，下载也能成功，只是你会得到能拿到的最好版本。

选择 最佳画质 可以总是拿到现有的最高画质；或者在“新建下载”面板（文件 → 新建下载…，⌘N，或链接栏里的选项按钮）里点 浏览格式，在下载前准确查看视频提供哪些格式。

“频率限制”

你在短时间内向服务器发了太多请求，它暂时屏蔽了你。这是网站在保护自己免受自动化滥用。

解决办法是耐心。等 5-10 分钟再试。如果一直发生，在 设置 → 下载 → 位置与队列 里调低 最大同时下载数——同时下载的视频越少，对服务器的压力越小。切换 IP 地址（通过代理）也可能有帮助，不过有些网站跟踪的不只是 IP。

网络错误

“超时”

服务器没有及时响应。可能是你的网速慢、服务器过载，或者你和内容之间的路由有问题。

首先确认你的网络正常——能正常打开网站吗？如果网络没问题但一直超时，在 设置 → 高级 → 下载引擎 里调高 连接超时。默认是 30 秒；调到 60 秒对慢速或远距离的服务器有帮助。如果某个网站总是超时，问题可能在他们那边——晚点再试。

“网络错误”

Fetchii 连不上，或者连接中断了。这包括连接被拒绝、连接断开以及无法解析的地址。

检查网站在浏览器里能不能用。如果不能，网站可能挂了。如果浏览器能用而 Fetchii 不行，网站可能在屏蔽下载工具。有些网站会采取措施阻止自动下载。晚点再试，或者看看网站有没有正规的下载选项。

如果你使用代理而代理连不上，错误会显示为“代理连不上”。请确认代理程序正在运行，并检查 设置 → 网络 里的地址和端口是否正确，或者关闭代理。

“SSL 错误”

建立安全连接时出了问题。这通常和系统配置有关，而不是你做错了什么。

确认 Mac 的日期和时间正确——SSL 证书对时间敏感，时钟不对会导致验证失败。也请确保 macOS 版本不要太旧，很老的系统可能不支持当前的安全标准。如果你在用代理，可以暂时关闭它，看看是不是代理的问题。

DNS 问题

当你的电脑无法查到域名对应的 IP 地址时，下载会失败并显示“网络错误”。这是 DNS 问题，不是 Fetchii 的问题。

试试更换 DNS 服务器。在系统设置 > 网络 > DNS 中添加 8.8.8.8（Google）或 1.1.1.1（Cloudflare）作为备选。你也可以清除 DNS 缓存——打开终端，运行 sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder。

文件系统错误

“磁盘已满”

空间不够保存下载。视频文件，尤其是高画质的，可能有好几 GB。

释放磁盘空间，或者在 设置 → 下载 → 位置与队列 里把 下载位置 改到空间更大的磁盘。如果空间紧张，选择较低的画质也有帮助。

“位置不可写”

Fetchii 无法写入你选择的下载文件夹。文件夹权限太严格、磁盘是只读的或已断开，或者 macOS 安全功能阻止了访问，都会导致这种情况。

试试下载到别的文件夹，比如“下载”或“文稿”文件夹。如果你确实需要使用受限的位置，在访达里检查文件夹的权限（文件 > 显示简介），或者在系统设置 > 隐私与安全性 > 文件与文件夹中给 Fetchii 授权。

“文件已不存在”

下载完成了，但找不到它的文件——比如在 Fetchii 收尾时文件被移动或删除了。重试下载即可。

你不用担心文件名无效：Fetchii 会自动替换 :、/、* 或 ? 之类的字符。如果文件名看起来不对，请检查 设置 → 下载 → 文件名与文件夹 里的模板（见自定义文件命名）。

转换错误

“处理错误”

视频已经下载，但收尾处理文件的步骤——比如合并视频和音频，或者移除 SponsorBlock 片段——失败了。

检查磁盘空间，因为处理时需要容纳文件的第二份副本，然后重试下载。如果同一个视频再次失败，试试别的画质或容器格式。

“转换失败”

转换你下载的文件时出了问题。转换出来的文件那一行会显示“转换失败”；把鼠标悬停在上面可以看到原因，用 移除 清除它。

检查磁盘空间——转换需要同时容纳输入和输出文件。在 转码视频 里试试别的编码：H.264 和 H.265 使用 Mac 的硬件编码器，VP9 用软件编码。如果你只是需要换一种文件类型，转换容器 不会重新编码，很少失败。如果源文件在播放器里都播不正常，文件本身可能已损坏。

引擎错误

“引擎不可用”

Fetchii 的下载引擎（真正负责获取视频的组件）还没安装，或者还在设置中。

Fetchii 会在首次运行时自动设置它；工具栏下方的通知栏会显示进度。等它完成后再重试。如果设置失败，通知会显示“设置失败”并带一个 重试 按钮——检查网络连接后再试。如果一直失败，可能有防火墙阻止了下载。

“引擎有更新”

网站经常改变视频分发方式，引擎需要更新才能跟上。有新引擎可用时，通知栏会显示“引擎有更新”。

点通知里的 立即更新。更新通常很小很快。如果一个原本能下载的网站突然出现“解析失败”，更新引擎往往就能解决。

“下载失败”

当 Fetchii 判断不出哪里出错时，就会显示这个——可能是视频文件不寻常，也可能是系统问题。

重试下载——第二次可能就成功了。如果同一个视频一直失败，这个视频可能有些特殊之处。试试别的画质或格式。如果多个视频都持续失败，建议检查 Fetchii 有没有更新（Fetchii → 检查更新…）。

获取帮助

如果你试过上面的办法还是有问题，以下是有效获取帮助的方法：

收集信息。 用 复制错误 拿到准确的错误文字，并记下你要下载的链接（如果不是私密的）、Fetchii 版本和 macOS 版本。

查看日志。 查看错误日志 会打开“诊断”并定位到这次失败的记录。你也可以随时从 设置 → 隐私 → 诊断 → 打开诊断… 打开它。日志里的错误信息往往比应用里显示的更详细。

先搜索。 很多问题之前已经有人遇到并解决了。快速搜索一下可能马上就能找到答案。

说具体。 在失败的下载上用 反馈此问题…，或者用 帮助 → 报告问题… 报告问题。说明你试了什么、发生了什么、你期望的是什么。“用不了”很难排查；“我用这些设置从网站 Y 下载时出现错误 X”就清楚得多。