Zotero PDF 下载失败怎么办？按故障范围快速排查与手动导入
简答：Zotero PDF 下载失败时，先不要急着重装：先判断是单个文件、单个网站还是所有网站都失败。最快的处理顺序是：打开 Zotero 桌面端并更新 Zotero Connector，确认浏览器扩展有权访问当前网站，再检查机构登录、代理和防火墙；如果条目已经保存但没有附件，优先右键条目选择“查找可用的 PDF（Find Available PDFs）”，仍失败就手动下载 PDF 后拖到对应条目下。
定义：Zotero PDF 下载失败，是指 Zotero 或 Zotero Connector 已保存文献条目，但无法自动取得、保存或关联该文献的 PDF 附件。
先看这张表：判断故障范围再动手
先用同一浏览器打开一个你确定可以访问的文献页面，再观察 Zotero 的表现。故障范围不同，排查方向也不同；不要一开始就删除数据库或反复重装。
| 现象 | 更可能的层级 | 先做什么 | 结果怎么判读 |
|---|---|---|---|
| 只有一个 PDF 下载失败 | 文件来源、重定向、权限或站点处理方式 | 在浏览器直接打开 PDF，确认是否需要登录、验证码或再次同意 Cookie | 浏览器也打不开，先处理访问权限；浏览器能打开但 Zotero 不能下，再检查 Connector 与代理 |
| 同一网站的多篇文献都失败 | 网站翻译器、机构代理或站点结构变化 | 刷新页面，等页面完全加载后再点击保存；检查 Connector 是否识别为文章或 PDF | 图标一直是灰色网页图标，说明当前页面未被正确识别或页面尚未完成加载 |
| 所有网站都失败 | Zotero、Connector、浏览器权限或本机网络 | 打开 Zotero 桌面端，检查 Connector 状态，并暂时停用其他扩展测试 | 停用其他扩展后恢复，说明存在扩展冲突；仍失败则检查代理、防火墙和安全软件 |
| 浏览器能下载，Zotero 不能下载 | Zotero 与浏览器使用的代理、Cookie、权限或网络路径不同 | 检查 Zotero 的系统代理设置、Connector 网站访问权限和机构代理记录 | 如果 Zotero 报“Error connecting to server”，优先查代理或安全软件，而不是简单判断为断网 |
| 只保存了条目，没有 PDF | 自动附件下载失败或来源没有可识别的全文链接 | 右键条目选择“查找可用的 PDF（Find Available PDFs）” | 有 DOI 或 URL 且条目没有现有 PDF 时，才更适合使用该功能；没有可访问全文时不会凭空生成附件 |
关于 Connector、翻译器、页面加载、扩展权限和 Debug ID，优先参考 Zotero 官方保存问题排查文档；文档中的菜单名称可能随 Zotero、浏览器版本变化，以当前界面为准。zotero.org
按最短顺序排查：先修复 Connector 和页面识别
- 确认 Zotero 桌面端正在运行。打开 Zotero 后重新加载文献页面，再点击浏览器工具栏中的保存按钮。Connector 可以在 Zotero 桌面端未打开时保存到在线库，但官方文档仍建议优先让桌面端运行，以便直接保存到本地库。若弹窗出现“Is Zotero running?”或提示 Zotero 不可用，先检查桌面端是否已启动。zotero.org
- 分别检查 Zotero 和 Zotero Connector。它们是两个独立组件：桌面端正常，不代表浏览器扩展一定是最新或已启用。Chrome 可打开
chrome://extensions，找到 Zotero Connector，确认开关已打开；Firefox 可在地址栏输入about:addons，进入“扩展”查看 Connector 是否启用。更新后重新启动浏览器和 Zotero。zotero.org - 让页面完整加载后再保存。如果保存图标是灰色网页图标，先刷新页面，等待文章信息、PDF 链接和登录状态加载完成；必要时按浏览器停止加载后再点击保存。对于只有 DOI、元数据或普通网页的页面，Zotero 可能只能保存条目，不能自动取得 PDF。
- 确认 Connector 有当前网站的访问权限。Chrome 中右键 Zotero 保存按钮，选择“此扩展程序可读取和更改网站数据”，将权限设为当前网站或所有网站；也可以进入“扩展程序”>“管理扩展程序”> Zotero Connector >“网站访问权限”。Firefox 中打开“扩展和主题”> Zotero Connector >“权限”，查看是否允许访问当前页面。只在信任的网站范围内授予权限。zotero.org
- 暂时停用其他扩展测试。广告拦截、隐私保护、脚本控制或其他下载扩展可能改变页面结构或阻断请求。先只保留 Zotero Connector，重新测试；如果恢复，再逐个启用其他扩展定位冲突。测试完成后，按需恢复安全扩展。
这一组操作主要解决“所有网站都失败”“保存按钮不见了”“图标一直灰色”和“Is Zotero running?”等问题。如果只是一个出版商网站失败，不要直接推断为本机故障，应继续检查该网站的登录、全文权限和 PDF 地址。
机构登录、代理与网络：浏览器能下但 Zotero 不能下
浏览器和 Zotero 可能没有使用完全相同的网络路径。Zotero 官方说明指出，连接错误通常与代理设置或安全软件有关；其他程序能联网，并不能证明 Zotero 使用的代理配置也正确。zotero.org
| 平台或浏览器 | 检查路径 | 应检查什么 |
|---|---|---|
| Windows | 设置 > 网络和 Internet > 代理 | 确认是否启用了不需要的手动代理、设置脚本或自动配置；如果机构提供 PAC 地址，不要擅自删除，先向机构信息部门确认。 |
| macOS | 苹果菜单 > 系统设置 > 网络 > 当前网络服务 > 详细信息 > 代理 | 检查自动代理发现、PAC、HTTP、HTTPS 或 SOCKS 配置是否与机构要求一致。 |
| Chrome | 右键 Zotero Connector > 选项；或 chrome://extensions > Zotero Connector > 扩展程序选项 | 检查 Connector 状态、代理记录和高级调试选项；若某个机构代理已失效，可在 Proxies 中删除后重新访问数据库，让 Connector 重新识别。 |
| Firefox | 地址栏输入 about:addons > Zotero Connector；或右键保存按钮进入偏好设置 | 检查扩展是否启用、页面权限和 Proxies 设置。Firefox 中的 Connector 菜单名称可能随版本变化。 |
Windows 的代理入口可参考 Microsoft 官方代理设置说明，macOS 的路径可参考 Apple 官方代理设置说明。系统菜单如果不同，以当前界面为准。support.microsoft.com
机构访问与 OpenAthens 的关系：如果文献页面要求高校或机构登录，先在浏览器完成机构认证，并确认当前页面已经显示可访问全文。OpenAthens、学校代理或其他机构访问系统本质上是访问授权与跳转路径；它们不保证每个 PDF 地址都能被 Zotero 自动识别。Connector 可以记住部分机构代理并自动重定向，但如果保存了过期代理，可能导致页面在 Connector 开启时打不开。此时打开 Connector 的 Proxies 设置，记录问题页面和 Debug ID，再删除失效代理并重新访问机构入口。zotero.org
如果 Zotero 报“Error connecting to server”，按以下顺序处理：先关闭不需要的系统代理；再确认机构 PAC 或代理地址；然后暂时检查防火墙、安全软件和 HTTPS 扫描功能。若出现证书错误，核对系统时间、证书颁发者和网络是否存在代理拦截，不要在不理解风险的情况下长期关闭安全检查。zotero.org
只保存条目没有 PDF：Find Available PDFs 与手动导入
如果文献条目已经在 Zotero 中，但附件栏为空，先选中条目并右键，查找“查找可用的 PDF（Find Available PDFs）”。该功能更适合已有 DOI 或 URL、且尚未附加 PDF 的条目；它仍然需要当前网络和机构权限能够访问全文。Zotero 官方社区给出的操作是选中条目后右键使用该功能，是否显示菜单取决于条目是否具备可检索信息。forums.zotero.org
- 在浏览器中打开文章的正式页面，先完成机构登录、Cookie 同意或必要的人机验证。
- 确认浏览器可以打开实际 PDF，而不是登录页、HTML 错误页或需要再次跳转的中间页面。
- 将 PDF 下载到本地。文件名可以保留原样，不要把网页保存成 PDF 后误当作正式附件。
- 在 Zotero 中选中对应的父条目，把 PDF 文件拖到该条目上；这样会作为子附件关联到已有条目，而不是另建一个无元数据的独立文件。
- 如果拖到空白区域，Zotero 可能创建独立附件。此时可以把独立 PDF 拖到正确的父条目上，或右键 PDF 使用“创建父条目”，输入 DOI 等标识符补齐元数据。
Zotero 官方文件说明建议优先使用存储型附件。通过“添加附件”纸夹按钮、右键“添加附件”或拖放文件，都可以把本地 PDF 加到已有条目；直接把 PDF 放进库中时，Zotero 也可能尝试自动识别元数据，但识别失败时会留下独立附件。zotero.org
避免重复条目的做法：先搜索标题、DOI 或作者，确认库中已有父条目，再把 PDF 拖到该条目上。若已经生成了重复条目，先保留元数据更完整、已有笔记和标签的那个，再合并或删除多余条目；不要在未确认附件已关联前清空原条目。
常见报错对应处理
| 报错或现象 | 优先处理 | 判读方向 |
|---|---|---|
Saving failed | 刷新页面、确认 Connector 与 Zotero 都已更新，检查网站权限；再停用其他扩展测试。 | 多个网站都失败，偏向 Connector、扩展或本机网络；只有一个网站失败，偏向站点翻译器或页面结构。 |
Is Zotero running? | 打开 Zotero 桌面端，重启浏览器和 Connector；在 Connector 偏好设置中查看 Zotero Status。 | 如果桌面端未运行，Connector 可能改为保存到在线库，行为与本地库不同。 |
Error connecting to server | 检查系统代理、PAC、防火墙、安全软件和证书；确认 Zotero 是否被单独拦截。 | 浏览器可联网不代表 Zotero 的代理配置正确。 |
| 保存按钮是灰色网页图标 | 确认网站是否受支持，等待页面加载完成后刷新；尝试文章主页面而不是中间跳转页。 | 灰色图标通常表示当前页面未被特定翻译器识别，可能只能保存普通网页或有限元数据。 |
| PDF 下载后是登录页或错误页 | 在浏览器直接打开文件并检查内容类型；重新完成机构认证，再复制真实 PDF 地址。 | 文件后缀为 PDF 不等于内容就是可用 PDF，重定向或权限失效时可能下载到 HTML 页面。 |
若仍无法复现，记录具体页面 URL、完整报错、Zotero 版本、Connector 版本、浏览器和操作系统。Connector 的偏好设置中可以提交错误报告或生成 Debug ID；官方排障文档也要求提供失败页面地址和弹窗内容，便于区分翻译器、权限与网络问题。zotero.org
FAQ：Zotero PDF 下载失败的三个常见疑问
为什么浏览器能打开 PDF，Zotero 却下载失败？
常见原因是两者使用的代理、Cookie、机构登录状态或扩展权限不同。先在同一浏览器确认 Connector 有权访问当前网站，再检查 Zotero 的系统代理和防火墙规则。如果浏览器打开的是登录后的临时地址，Zotero 直接请求该地址时也可能没有相同的会话权限。
为什么 Zotero 只保存了条目，没有自动附件？
自动附件下载依赖页面识别、全文权限和可用的 PDF 链接。先右键条目使用“查找可用的 PDF（Find Available PDFs）”；如果仍无结果，手动下载 PDF，再拖到已有父条目上。Zotero 的“自动附加相关 PDF”选项也可以在首选项的常规设置中检查，但打开该选项并不能绕过登录、权限或站点限制。zotero.org
是否应该直接重装 Zotero？
不建议把重装作为第一步。先区分故障范围，检查 Zotero 桌面端、Connector、浏览器权限、扩展冲突和代理；只有在多个网站都失败且基础检查无效时，才考虑重新安装相关组件。重装前先确认数据目录、同步状态和本地附件已备份，避免把连接问题误处理成数据问题。
机构代理会不会让 Zotero 自动跳错网站？
可能会。Connector 可以保存并自动使用机构代理；如果代理入口过期、域名规则不匹配或当前网络已经不需要该代理，页面可能在 Connector 开启时无法访问。进入 Connector 的 Proxies 设置查看已保存项目，必要时删除失效记录后重新从机构入口访问。zotero.org
结论与边界说明
解决 Zotero PDF 下载失败，最有效的顺序通常是：判断故障范围 → 确认 Zotero 与 Connector 都在运行并更新 → 检查浏览器网站权限 → 完成机构登录并核对代理 → 使用“查找可用的 PDF” → 手动下载并关联到已有条目。页面路径和功能名称会随 Zotero、Connector、Windows、macOS、Chrome 与 Firefox 版本变化，操作时以当前界面和官方文档为准。
如果问题只发生在某个出版商、数据库或单个 PDF，不能仅凭一次失败断定是线路问题；应同时记录具体网址、登录状态、报错内容和浏览器能否直接打开文件。本文不提供绕过访问限制的方法，也不建议关闭安全软件后长期使用。
结尾推荐框为本站商业推广。
常见问题
为什么浏览器能打开 PDF，Zotero 却下载失败？
浏览器与 Zotero 可能使用了不同的代理、Cookie、机构登录状态或扩展权限。先确认 Connector 可访问当前网站，再检查 Zotero 的系统代理、防火墙和安全软件设置。
Zotero 只保存了条目，没有 PDF，怎么办？
选中条目后右键使用“查找可用的 PDF（Find Available PDFs）”。如果仍无结果，先在浏览器完成机构登录并手动下载 PDF，再将文件拖到已有父条目上。
遇到 Saving failed 或 Error connecting to server，要不要重装？
先不要重装。分别检查 Zotero 桌面端、Connector、浏览器权限、扩展冲突、系统代理、PAC、防火墙和证书问题；仍无法解决时，再记录版本、网址、报错和 Debug ID。
机构代理或 OpenAthens 会影响 PDF 自动下载吗？
会影响。机构认证决定是否有全文权限，代理决定请求如何到达数据库；Connector 虽可记住部分代理，但过期或错误的代理记录可能导致访问失败。
相关阅读
参考资料
- Zotero 官方：Troubleshooting Problems Saving to Zotero
- Zotero 官方：Error connecting to server
- Zotero 官方：防火墙需要允许哪些连接
- Zotero 官方：Connector 偏好设置、代理与 Debug ID
- Zotero 官方：代理重定向排查
- Zotero 官方：向文献库添加文件
- Zotero 官方：如何将文件或网页附加到条目
- Zotero 官方论坛：PDF 检索与 Find Available PDFs
- Microsoft 官方：Windows 代理服务器设置
- Apple 官方：macOS 代理设置
- Google Chrome 官方：安装和管理扩展程序
- Mozilla 官方：查看 Firefox 已安装扩展及权限