Zotero 同步失败怎么办？从条目、PDF到多设备排查

更新于 2026-10-19 · jetstream.mom

简答：换了电脑后条目在、PDF打不开，或同步图标一直转圈时，先不要重装或使用“Replace Online Library”。先打开 zotero.org 网页库确认内容是否已上传，再区分条目数据同步和 PDF 附件同步，最后检查账号、文献库、配额、WebDAV、代理与防火墙。

定义：Zotero 同步分为条目数据同步和附件文件同步：前者处理文献条目、笔记等数据，后者处理 PDF、网页快照和其他附件，二者的故障原因并不完全相同。

先做这一步：看网页库，再判断是哪一类同步失败

先在浏览器登录 Zotero 网页库，检查出问题的条目是否已经出现。网页库没有条目，优先排查产生修改的设备；网页库已有条目而另一台设备没有，重点检查目标设备。桌面端同步图标仍在转动时，先悬停查看进度；桌面端红色错误图标，或 iOS、Android 页面底部出现错误提示时，点击或轻触查看完整信息。Zotero 数据同步排查文档

同步现象与第一动作对照

看到的现象	优先判断	第一动作
条目、笔记或标签没有出现在另一台设备	数据同步问题	检查网页库、账号和需要同步的文献库。
条目已经出现，但 PDF 或网页快照打不开	文件同步、配额或文件位置问题	在添加附件的设备上打开文件，再检查在线库是否能打开附件。
同步图标一直转圈	同步可能尚未完成	悬停查看进度，不要立即切换账号或重置。
每次同步刚开始就立即失败	代理、安全软件或防火墙干扰	检查系统代理和网络安全规则，重启后再试。
同一个冲突窗口反复出现	冲突处理没有完成，或同步错误阻止保存选择	完成冲突窗口中的 Next/Finish，并查看同步错误图标。

安全顺序：先备份 Zotero 数据目录，再看网页库；随后区分条目和附件，检查账号、文献库、配额、WebDAV与网络；仍无法复现解决时，再准备 Report ID 或 Debug ID；最后才考虑特定的文件同步重置。不要把“Replace Online Library”当作普通的重新同步按钮。Zotero 数据目录说明 Zotero 同步重置说明

Windows、macOS、iOS、Android分别从哪里检查

桌面端的通用入口是 Zotero 设置中的 Sync 面板；Windows 通常可从 Edit → Settings → Sync 进入，macOS 通常可从 Zotero → Settings → Sync 进入。不同版本的菜单名称可能变化，应以当前版本界面为准。官方文档确认，Sync 面板包含 Settings 和 Reset 两个标签，并在 Settings 中管理账号、数据同步、文献库选择和文件同步。Zotero Sync 设置文档

Windows：打开 Zotero 设置→Sync，确认账号已连接，点击“Choose Libraries…”检查需要同步的群组文献库；再确认文件同步方式和下载策略。
macOS：打开 Zotero 设置→Sync，按同样顺序检查账号、文献库、文件同步和 WebDAV；如果菜单位置不同，以当前版本界面为准。
iOS：下拉文献列表触发同步；如果底部出现错误提示，轻触错误信息查看详情。官方文档说明，iOS 无法手动生成 Report ID，但可以为具体操作生成 Debug ID。
Android：下拉文献列表触发同步；如果底部出现错误提示，轻触查看完整信息。官方文件同步排查文档建议为相关操作生成 Debug ID，并在求助时附上错误信息。

移动端也可以通过 Zotero 网页库进行对照：如果网页库已有条目而移动端没有，优先处理移动端同步状态；如果网页库也没有，则回到添加或修改内容的设备排查。Zotero 移动端文档 Zotero 附件同步排查文档

看到这些报错或现象，分别怎么处理

官方报错文字与处理动作

报错或现象	常见定位	可执行动作
`The attached file could not be found`	附件尚未上传、文件在另一台设备、链接文件路径不存在，或本地文件被移走	先在添加文件的设备打开附件；再检查网页库或 WebDAV 中是否能打开该文件。
`The attached file could not be found at the following path...`	桌面端找不到本地附件路径	确认文件是否被移出 Zotero 数据目录；如果是链接文件，检查原路径或转换为存储文件。
每次同步一开始就出现 file sync error，且没有新的进度	代理服务器、安全软件或防火墙可能拦截	检查系统代理、终端安全软件和网络规则，重启 Zotero 后再试。
文件同步偶尔失败，但每次重试都有进度	批量文件同步中的暂时性失败	再次点击同步，或保持自动同步，让客户端继续重试。
冲突窗口反复出现	冲突选择没有点击 Next/Finish，或底层同步错误阻止保存	完成冲突处理后查看同步错误图标；若仍重复，记录 Debug ID。
只看到附件条目，打开时才下载	文件下载策略设置为“As needed”	这不一定是数据同步失败；检查 Sync 面板中的下载策略。

其中“附件找不到”的英文提示和移动端提示可直接在官方文档中核对。若文件在添加它的设备上也打不开，先处理本地文件位置或数据目录，不要在另一台没有该文件的设备上反复重置。Zotero 官方附件找不到排查文档 Zotero 存储文件找不到说明 Zotero 重复冲突说明

条目同步了但 PDF 不同步：检查存储、配额和 WebDAV

条目、笔记和附件文件不是同一条同步通道。桌面端在 Sync 面板中分别管理数据同步和文件同步；个人库附件可以选择 Zotero 文件存储或 WebDAV，群组文献库附件使用 Zotero 文件存储。选择 WebDAV 时，需要核对服务方提供的地址、用户名和密码，并点击“Verify Server”检查连接；Zotero 会自动在地址末尾添加 /zotero，因此地址格式应以当前界面和服务方文档为准。Zotero 文件同步设置文档

先确认文件类型：带链条标识的链接文件只保存原文件位置，换设备后原路径不存在时，条目可以同步但 PDF 不能打开。官方文档建议将需要由 Zotero 管理的附件转换为存储文件。
检查在线库：如果使用 Zotero Storage，在网页库中直接打开附件；仅看到附件条目并不代表文件本身已上传。如果使用 WebDAV，需在 WebDAV 服务端确认对应文件存在。
检查配额：在线存储配额只针对上传到 Zotero 服务器的文件，不等于本地硬盘容量。删除文件后还要清空 Zotero 回收站，否则文件仍计入配额。配额已满时，可删除并永久移除不需要的在线文件，或在存储设置中选择适合的存储方案。
检查下载策略：“At sync time”会在同步时下载附件；“As needed”则在打开附件时下载。后者可能让设备暂时只有条目而没有本地 PDF。

如果网页库已经能打开 PDF，但目标设备仍打不开，检查两台设备是否使用同一账号、同一文献库和一致的文件同步方式；如果网页库也打不开，问题发生在添加文件的设备、上传过程、配额或 WebDAV 配置。Zotero 存储配额说明

同步一开始就失败：按代理、网络和防火墙顺序排查

先做网络对照：在同一设备上，用另一条允许正常访问 Zotero 网页库的网络测试一次。这个对照只能帮助判断是否与当前校园网、公司网络或公共 Wi-Fi 有关，不能单独证明是服务端故障。
检查代理：如果没有使用代理，确认系统代理没有残留配置；如果正在使用代理，核对地址、端口和认证信息。代理设置入口以当前 Windows 或 macOS 版本界面为准。
检查安全软件：确认防火墙、终端安全软件或公司网络策略没有阻止 Zotero 建立 HTTPS 连接。官方说明指出，Zotero 需要连接多个 zotero.org 子域名，不能简单依赖固定 IP 做长期放行。
重启并观察：重启 Zotero 后再次同步，判断是继续出现进度、立即报错，还是只卡在某个附件。

如果网页库能打开而桌面端每次刚开始同步就失败，重点查看桌面端错误详情和代理、防火墙设置；如果网页库本身也无法访问，先处理当前网络路径。Zotero 文件同步错误文档 Zotero 防火墙连接要求

边界云加速是本项目自有产品，不是 Zotero 官方支持渠道。

什么时候继续重试，什么时候提交 Report ID 或 Debug ID

文件同步偶发报错且重试时能看到进度，可以再次点击同步或让自动同步继续运行。若每次从开始位置立即失败，或错误稳定复现，则不要反复切换账号、删除数据库或覆盖在线文献库，应记录问题并准备求助材料。Zotero 文件同步错误处理建议

桌面端：在重启 Zotero 前，打开 Help 菜单，选择“Report Errors…”，提交后复制数字 Report ID。对于某个具体操作可以稳定复现的问题，Debug ID 可能更有用。
iOS：不能手动生成 Report ID，但可以为具体操作提供 Debug ID。
Android：记录下拉列表同步后底部显示的完整错误，并按附件或数据同步文档要求为相关操作准备 Debug ID。
提交内容：写明操作系统、Zotero 版本、发生问题的步骤、完整报错、网页库是否已有条目或附件、使用 Zotero Storage 还是 WebDAV，以及问题发生在条目还是文件。

“Replace Online Library”会用本地数据库覆盖在线文献库，只适用于你明确要撤销在线库已有变化、已经备份并确认本地版本正确的情况；它不是普通的同步修复按钮。Sync→Reset 中的其他选项也只适用于特定情况，官方不建议把它们用于一般排错。Zotero 问题报告说明 Zotero 同步重置选项

常见问题

Zotero 同步失败时，先重装软件可以吗？

不建议。先备份数据目录，检查网页库、账号、文献库和同步类型，再检查配额、WebDAV、代理与防火墙。重装不会自动修复错误账号、错误数据目录或在线存储配额问题。

为什么 Zotero 条目同步了，但 PDF 没有同步？

条目属于数据同步，PDF 属于附件文件同步。请检查 PDF 是存储文件还是链接文件，个人库是否启用了 Zotero Storage 或 WebDAV，在线配额是否已满，以及目标设备是否使用“As needed”下载策略。

Zotero 一直转圈但没有报错怎么办？

先悬停桌面端同步图标查看是否仍有进度。如果进度变化，先让同步继续或再次点击同步；如果每次都从开始位置卡住，检查代理、防火墙、安全软件和当前网络。

看到“The attached file could not be found”怎么办？

先到添加该文件的设备上确认 PDF 能否打开，再检查网页库或 WebDAV 中是否已有该文件。如果是链接文件，检查原路径；如果是存储文件，检查数据目录、上传状态和文件同步配置。

为什么冲突窗口每次同步都会重复出现？

先确认每次选择后都点击了 Next 或 Finish。如果仍然重复，查看同步图标旁是否有错误图标；官方说明指出，同步错误可能导致冲突选择无法保存，此时应记录 Debug ID。

可以使用“Replace Online Library”修复同步失败吗？

不要把它当作普通修复按钮。该操作会用本地数据库覆盖在线文献库，只有在已经备份、确认本地版本正确，并且明确要撤销在线库已有变化时才考虑。

什么时候应该向 Zotero 官方论坛求助？

当错误可以稳定复现、网页库与设备状态持续不一致，或无法判断哪份数据正确时，停止删除、切换账号和重置操作，准备 Report ID 或 Debug ID、系统与版本、完整报错及复现步骤。