Zotero Connector 抓取失败怎么办？按症状快速修复网页保存
简答：先打开 Zotero 桌面端，再访问 127.0.0.1:23119/connector/ping；若连接正常，检查 Connector 的网站访问权限、扩展冲突和机构代理。只缺 PDF 时不要反复点击保存，改用“查找可用 PDF”或手动下载后关联条目。
定义：Zotero Connector 抓取失败，是浏览器扩展无法正确识别网页元数据、连接 Zotero 桌面端，或保存条目与附件时发生错误。
先做这一步：用本机连接测试判断故障范围
本站与 Zotero 无关联。遇到 Zotero Connector 抓取失败，不要先重装 Zotero，先区分是网页识别失败，还是浏览器根本无法连接桌面端。
- 打开 Zotero 桌面端，保持软件运行。
- 在浏览器地址栏打开
http://127.0.0.1:23119/connector/ping。 - 如果页面显示“Zotero is running”或“Zotero Connector Server is Available”，说明本机连接服务正在响应，继续检查浏览器权限、扩展冲突或具体网站。
- 如果页面打不开，优先检查 Zotero 是否运行、代理是否错误转发了本机地址，以及防火墙或安全软件是否拦截了本地端口。
Zotero 官方建议在桌面端运行后重启浏览器；若 Connector 仍显示 Zotero 不可用，可用上述地址判断问题发生在浏览器层还是系统层。Zotero 官方“Is Zotero Running?”排查说明
| 现象 | 优先判断 | 最快动作 |
|---|---|---|
| 保存按钮灰色或无反应 | 网站访问权限、扩展冲突或页面未完成加载 | 刷新页面，检查 Connector 是否允许访问当前网站 |
| 提示 Zotero 未运行 | 桌面端或本机连接服务异常 | 启动 Zotero，再测试 127.0.0.1:23119 |
| 能保存条目但没有 PDF | 附件权限、登录状态或网站未提供可抓取 PDF | 使用“查找可用 PDF”，失败后手动下载并关联 |
| 启用 Connector 后网站打不开 | 已保存的机构代理记录失效 | 检查 Proxies，临时删除对应代理记录 |
保存按钮灰色、抓成普通网页或点击无反应
Connector 会根据当前页面识别文章、图书、期刊、数据库记录或 PDF。若图标始终是普通网页图标，通常不是 Zotero 文库损坏，而是当前页面没有被正确识别、页面仍在加载，或扩展没有获得足够的网站访问权限。
- 先确认你打开的是出版商文章页、数据库记录页或 DOI 页面，而不是搜索结果页、登录跳转页或嵌入式阅读器。
- 等待页面正文和标题加载完成，再刷新一次。
- 点击浏览器扩展菜单，确认 Zotero Connector 已启用，并允许访问当前网站；如果需要在多个网站自动识别，可将访问范围设为所有网站。
- 临时停用广告拦截、脚本拦截、隐私保护和其他会修改网页的扩展，再测试同一页面。
- 换一个浏览器或新建浏览器配置文件测试。若新配置文件正常，问题多半在原配置文件中的扩展或站点设置。
Chrome 和 Edge 可在扩展详情中调整网站访问范围；Firefox 可从 Connector 的偏好设置入口检查扩展状态；Safari 需要在 Safari 设置的“网站”或“扩展”区域允许 Zotero Connector 访问其他网站。Zotero 官方权限说明 Chrome 官方扩展权限说明
如果只在一个网站失败，先不要把它归因于网络。可能是该站页面结构、登录状态或 Zotero 翻译器尚未适配。可以先保存页面本身，再从页面导出的 RIS、BibTeX 或其他引文文件导入条目。
提示“Is Zotero running?”：按桌面端、浏览器、系统三层处理
出现“Is Zotero running?”或“无法与 Zotero 桌面应用通信”时，按下面顺序操作：
- 桌面端：确认 Zotero 已安装并打开，不要只打开浏览器扩展。
- 浏览器：完全退出并重新打开浏览器，再重新点击保存。
- 本机服务：访问
http://127.0.0.1:23119/connector/ping。如果该地址可打开但扩展仍报错，重点检查 Connector 网站权限和扩展冲突。 - 代理：如果系统或浏览器使用代理，确保
127.0.0.1不被转发到代理服务器。 - 安全软件：临时停用防火墙或安全软件做一次对照测试；确认原因后，应优先添加允许规则，而不是长期关闭防护。
如果所有浏览器都无法打开本机测试地址，Zotero 官方建议使用“帮助 → 调试输出日志 → 启用日志并重启”，再查看日志中的 HTTP server 信息。日志中若出现 HTTP server listening on 127.0.0.1:23119，通常表示 Zotero 已监听，问题可能在其他软件拦截；若出现未初始化或离线提示，则应继续检查 Zotero 本身、网络和系统代理。官方本机连接排查步骤
按浏览器检查 Connector 导入、开启与验证
以下按 2026-10 界面核对。不同浏览器版本的菜单文字可能略有差异，但排查逻辑相同。
Chrome
- 导入：从 Chrome 扩展商店安装 Zotero Connector，或在已有扩展中打开其详情页。
- 开启：在扩展管理页确认扩展已启用，并将“网站访问权限”设为当前网站或所有网站。
- 验证：打开文章页点击保存，随后查看 Zotero 是否出现新条目；失败时访问本机 ping 地址。
日志入口：右键 Connector 图标进入 Preferences/Options，再到 Advanced 或 Report Errors 区域提交报告。Zotero 官方问题报告说明
Edge
- 导入：从 Edge 扩展管理页安装或启用 Zotero Connector。
- 开启：在扩展详情中检查“读取和更改网站数据”的范围。
- 验证：返回文章页刷新后点击 Connector；若仍提示未运行，测试
127.0.0.1:23119。
日志入口：从 Connector 图标的右键菜单进入 Preferences/Options，再打开 Advanced 或 Report Errors。
Firefox
- 导入：从 Firefox 扩展管理页安装 Zotero Connector。
- 开启：确认扩展已启用，并从 Connector 的 Preferences 检查 General、Proxies 和 Advanced。
- 验证：打开出版商页面，点击保存，再检查本地库或在线库是否出现条目。
日志入口：Connector Preferences 的 Advanced 区域。若只有 Firefox 失败，可暂时停用其他扩展或建立新配置文件。
Safari
- 导入：Zotero 官方说明 Safari Connector 随 Zotero 提供，需要在 Safari 设置的扩展区域启用。
- 开启：在 Safari 设置的 Websites/Extensions 区域，将“其他网站”对 Zotero Connector 设为允许。
- 验证：重新打开文章页，右键页面或使用扩展按钮保存，并检查 Zotero 条目。
日志入口：右键网页打开 Zotero Preferences，再进入 Advanced 或 Report Errors。Safari 不提供 Connector 的 Proxies 功能。Zotero Connector 官方使用说明
单个网站失败：检查翻译器、登录状态和机构代理
如果其他网站都能保存，只有一个出版商、数据库或期刊平台失败，优先按“网站特有问题”处理：
- 确认页面已经登录，并且不是需要再次验证的跳转页。
- 从搜索结果页进入具体文章记录页，不要直接把检索列表当作文章条目保存。
- 在 Connector 偏好设置中检查错误报告和高级选项，必要时生成 Debug ID。
- 如果启用了机构代理、OpenAthens 或 PAC，检查 Connector 是否把当前域名重定向到了失效代理。
- 打开 Connector 的 Proxies 设置，记录相关代理的 Hostname 和 Scheme；确认无误后，可删除失效记录并重新访问机构入口。
Zotero 官方指出，Connector 可能自动保存并使用机构代理；若启用 Connector 后网站打不开，而关闭扩展或换浏览器后恢复，应优先检查已保存的代理记录。该官方代理排障页面最后更新于 2025 年 1 月 31 日。官方代理排障说明 官方 Proxies 设置说明
生成 Debug ID 时，记录失败页面、浏览器、操作系统、是否登录机构账号以及复现时间。不要在公开日志中粘贴密码、访问令牌或私人文献内容。
只保存条目没有 PDF：不要把元数据失败和附件失败混为一谈
“抓到文章信息但没有 PDF”与“网页元数据抓取失败”是两类问题。条目已经出现时，说明基本的元数据保存流程可能成功，缺少的是附件获取、权限验证或开放版本匹配。
- 在 Zotero 中选中父条目，使用“查找可用 PDF”功能。
- 如果页面需要机构登录，先在浏览器中完成登录，再回到条目重试。
- 如果 PDF 只能在阅读器或下载按钮中取得，直接在浏览器下载文件。
- 把下载后的 PDF 拖到对应父条目上，或先选中父条目再添加附件。
- 若下载文件是扫描件或没有文本层，后续全文检索能力可能受限；这属于 PDF 内容层问题，不一定是 Connector 抓取失败。
浏览器能打开 PDF 但 Zotero 无法保存时，检查网站访问权限、弹窗或下载拦截规则，并确认安全软件没有阻止 Zotero 访问文件。若所有网站的附件获取都失败，再检查系统代理、防火墙和 Zotero 网络连接。Zotero 官方连接错误说明
仍然失败时：记录可复现信息，再决定是否重装
重装前先保护数据。不要直接删除 Zotero 数据目录，也不要在未确认同步状态时清空本地库。优先收集以下信息：
- 失败页面类型：普通网页、DOI 页面、出版商文章页、数据库记录页或直接 PDF。
- 失败范围：一个网站、多个网站，还是所有网站。
- 按钮状态：灰色、无反应、保存后消失、提示未运行或提示连接错误。
- 环境信息：Zotero 版本、Connector 版本、浏览器、操作系统、是否使用系统代理或机构代理。
- 测试结果：本机 ping 地址是否可打开、换浏览器是否正常、停用扩展后是否恢复。
如果问题只发生在原浏览器，先建立新配置文件；如果所有浏览器和新系统账户都失败，再考虑系统级安全软件、代理或端口占用。需要向官方论坛求助时，可从 Connector 的 Report Errors 入口提交 Report ID，并同时说明浏览器、系统和 Zotero 版本。官方报告问题指南
网络层排查可按“本机连接、浏览器权限、代理、防火墙、目标网站”顺序进行。多网络、多设备对照后仅目标服务异常时，再考虑已公开主体信息的服务；使用任何网络服务都应遵守所在地法律与服务条款。
常见问题
Zotero Connector 必须一直打开 Zotero 桌面端吗？
不是绝对必须。Connector 可以在 Zotero 未运行时保存到 zotero.org 在线库，但官方仍建议优先运行桌面端，以获得更完整的本地保存体验。若希望保存到本地库，应先启动 Zotero。
为什么浏览器可以打开网页，Zotero Connector 却抓取失败？
网页能打开只说明浏览器完成了页面访问，不代表 Connector 能读取页面结构、访问相关资源或连接 Zotero。本机端口、扩展权限、广告拦截器、翻译器和机构代理都可能单独影响抓取。
把 Connector 的网站访问权限设为所有网站安全吗？
该权限用于让扩展读取页面内容、识别条目类型并执行保存。Zotero 官方说明，数据通常在你点击保存后才用于保存到本地库或在线库；如仍有隐私顾虑，可先设置为当前网站或指定网站，并按需扩大范围。
只在一个期刊网站抓取失败，要不要马上重装 Zotero？
通常不必。先确认文章页已加载、账号已登录，停用冲突扩展，并检查翻译器或机构代理。单站点失败更像页面结构、登录状态或代理问题，重装桌面端未必能解决。
删除 Connector 的代理记录会不会影响 Zotero 文库？
删除的是 Connector 保存的代理配置，不等于删除文库条目或附件。若该代理仍在使用，删除后可能需要重新从机构入口访问一次，让 Connector 重新识别；操作前应记录 Hostname 和 Scheme。
Zotero 抓不到 PDF，是不是网页元数据也失败了？
不一定。若条目已经保存，元数据流程可能已经成功，缺失的是附件下载、机构权限或开放版本匹配。可先使用“查找可用 PDF”，再手动下载并拖到正确的父条目下。