Zotero 同步冲突怎么办？安全处理与恢复步骤
简答：Zotero 出现同步冲突时，先暂停自动同步并备份本地数据目录，再确认问题属于条目数据冲突、PDF附件同步失败，还是同步错误。一般条目冲突应在冲突窗口中比较本地版、远程版和合并结果，并点击 Next/Finish 完成；如果冲突反复出现，应优先查看同步错误图标，而不是反复选择版本。只有在线库已经被错误更改时，才考虑 Replace Online Library。
定义：Zotero 同步冲突，是同一条目在本地、在线库或其他设备被分别修改后，Zotero 无法自动判断应保留哪一份内容而要求用户处理的情况。
结论速查：先判断你遇到的是哪一种问题
不要一看到“同步冲突”就重置或覆盖在线库。Zotero 的数据同步和文件同步是两条不同链路：条目、笔记、标签等属于数据同步；PDF、图片、音频等附件属于文件同步。官方文档明确说明，附件文件不会随普通数据同步自动完成，需要另外配置 Zotero Storage 或 WebDAV。查看 Zotero 官方同步说明
| 现象 | 优先判断 | 第一步 | 不要马上做什么 |
|---|---|---|---|
| 弹出本地版、远程版选择窗口 | 条目数据冲突 | 先备份，再比较字段和笔记 | 不要直接选择覆盖全部内容 |
| PDF打不开、附件一直等待或报文件错误 | 文件同步问题 | 检查附件同步方式、网络、代理和存储设置 | 不要用网盘直接同步 Zotero 数据目录 |
| 处理后下次同步仍出现同一冲突 | 同步错误未解决 | 查看同步图标旁的错误提示并记录 Debug ID | 不要重复点击同一选项期待自动修复 |
| 误删或错误修改已经传到在线库 | 在线库需要回退 | 停用自动同步并准备可用备份 | 不要在没有备份时使用 Replace Online Library |
最快安全路径：暂停自动同步 → 备份数据目录 → 打开 Web Library 比较 → 处理冲突窗口并点击 Next/Finish → 再手动同步 → 若仍失败，转入错误图标、账号、库设置和网络排查。
前置条件：操作前先保护本地数据
- 暂停自动同步：在 Zotero 的同步设置中取消“自动同步”，避免你还没有判断版本时，新的修改继续上传或下载。官方设置文档说明，自动同步开启时，库发生变化后会自动发起同步；也可以通过工具栏同步按钮手动同步。查看同步设置说明
- 备份数据目录：关闭或暂时退出 Zotero 后，复制当前数据目录到外部磁盘或其他安全位置。至少保留一份未被后续操作覆盖的副本。官方明确要求，在使用同步重置操作前先备份 Zotero 库。查看同步重置前的备份要求
- 确认账号和库：检查当前客户端登录的账号是否与在线库及其他设备一致；如果是群组库，还要确认当前账号仍属于该群组。账号不一致或群组成员资格变化，都可能造成“某台设备看不到修改”的假象。查看官方同步变化排查
- 记录现象：记下冲突条目标题、所在库、是否有PDF附件、同步图标是否出现红色错误标记，以及错误提示原文。后续需要求助时，这些信息比“同步不了”更有用。
如果无法确定哪个版本正确，先不要选择“保留本地”或“保留远程”。可以先把两侧的关键字段、笔记和附件状态截图或导出，再进行选择。
最短流程：处理条目数据同步冲突
- 先看在线库：登录 Zotero Web Library，找到冲突条目，确认在线库是否已经包含你想保留的标题、作者、年份、标签或笔记。若在线库没有这次修改，问题可能发生在产生修改的设备上；若在线库已有内容，则要继续比较本地版本。
- 打开冲突窗口：在桌面客户端执行一次手动同步，出现冲突窗口后，逐项比较本地版本和远程版本。不要只看条目标题，还要检查作者、出版物、日期、标签、笔记和关联附件。
- 选择保留方式：只在本地版本明确正确时保留本地；只在在线库版本明确正确时保留远程；两侧各有有效内容时，使用合并思路逐项保留，而不是简单覆盖。具体字段和按钮名称可能随客户端界面变化，以当前窗口显示为准。
- 完成窗口操作：每次处理后点击右下角的“Next”或“Finish”。官方说明指出，如果没有完成冲突处理流程，选择结果不会保存；窗口较小时可能看不到按钮，需要放大窗口。查看反复冲突的官方解释
- 再次手动同步：等待同步结束，确认没有红色错误图标，再到 Web Library 和另一台设备检查条目是否一致。
成功标准：冲突窗口不再重复出现；同步图标完成后没有错误提示；Web Library、当前设备和另一台设备的关键字段一致；需要同步的附件也显示为可打开或已完成。
同步冲突反复出现：区分“没点完成”和“同步错误”
如果你已经正确选择版本并点击了 Next/Finish，但下次同步仍显示同一条冲突，通常不应继续重复选择。Zotero 官方说明，这种情况往往是同步错误导致：冲突窗口中的选择没有成功保存，下一次同步又会显示同样内容。先看工具栏同步图标左侧是否出现错误图标，点击它查看具体错误。查看官方排查路径
- 点击或悬停同步错误图标，复制完整错误信息。
- 确认当前设备访问在线库是否稳定，检查系统代理、安全软件或网络过滤是否干扰同步。
- 确认同步设置中目标库已启用；官方建议在“Choose Libraries…”中检查对应库是否勾选。
- 确认所有设备使用同一个账号，群组库则确认账号仍具备成员资格。
- 在完成一次能复现问题的同步后生成 Debug ID；如果需要向官方社区求助，同时提供错误信息、受影响条目和必要的 Report ID。查看 Report ID 与 Debug ID 的提交建议
如果错误在每次同步刚开始就出现，且文件同步进度没有变化，优先检查代理设置和安全软件。官方文件同步排查文档指出，网络安全软件或代理可能在文件同步开始阶段造成干扰；确认设置后可重启 Zotero 再试。查看文件同步错误说明
PDF附件重复、打不开或同步失败：不要当成条目冲突处理
条目冲突只解决文献记录本身，不会自动修复所有附件问题。Zotero 官方将数据同步和文件同步分开：数据同步覆盖条目、笔记、标签等内容；PDF等附件需要通过 Zotero Storage 或 WebDAV 进行文件同步。群组库的附件文件同步只支持 Zotero Storage。查看数据与文件同步区别
- 只有条目一致、PDF缺失：检查同步设置中的附件文件同步方式，以及当前库是否启用了对应文件同步。
- PDF可以在在线库看到、当前设备打不开：确认当前设备是否正在下载附件，检查本地磁盘空间、代理和网络连接，不要先删除本地附件。
- 反复出现文件同步错误：先再次点击同步或等待自动同步重试；如果每次刚开始就失败，检查系统代理、安全软件和网络策略。查看官方文件同步恢复建议
- 附件出现多个副本：先确认是否是同一条目下的多个附件，而不是两个重复条目。可在处理重复条目前保留原始文件，并记录附件所在条目。
不要把 Zotero 数据目录放进普通网盘同步文件夹，也不要让多个设备同时直接改写同一个本地数据库。跨设备使用时，应让 Zotero 自己负责数据同步，再按官方支持的方式配置附件文件同步。
误删或错误修改已同步：什么时候使用 Replace Online Library
“Replace Online Library”不是普通同步修复按钮，而是用本地数据库覆盖在线库的特殊操作。官方文档将其限定在在线库已经含有错误修改、并且你有明确正确的本地版本时使用；普通的本地新增或删除，通常不需要通过该功能处理。查看 Replace Online Library 的适用范围
适合考虑的情况
- 错误修改已经上传在线库，需要用经过核对的本地备份回退。
- 本地和在线库都包含错误变化，但你能从备份恢复出明确正确的本地库。
- 你已暂停自动同步，并确认选择的是正确的库。
不适合直接使用的情况
- 只是本地新增了条目，在线库暂时还没有显示。
- 只是某台设备还没有完成同步。
- 只是PDF附件下载慢、代理不通或文件同步报错。
- 你还没有备份，也无法确认本地版本是否正确。
如果确实需要回退，先停用自动同步，备份当前数据目录，从外部备份或 Zotero 自动备份恢复本地数据，再按当前客户端同步设置中的重置入口执行。重置页面的菜单和提示可能随版本变化，执行前应逐项阅读当前界面，必要时先在官方社区确认。
分层排错：网络、代理与客户端设置逐项检查
| 排查层 | 检查内容 | 判读标准 | 回退或下一步 |
|---|---|---|---|
| 在线库 | Web Library 是否出现目标条目或修改 | 在线库有内容：重点查当前设备；在线库没有：重点查产生修改的设备 | 不要先改另一台正常设备 |
| 账号与库 | 账号、个人库、群组库和 Choose Libraries 设置 | 三者必须对应，群组库需仍有成员资格 | 修正账号或库勾选后重新手动同步 |
| 同步状态 | 同步图标是否仍旋转、是否有红色错误图标 | 仍旋转表示未完成；红色图标表示需要查看错误 | 等待完成或记录错误信息 |
| 网络 | 代理、DNS、安全软件、办公网络策略 | 文件同步一开始就失败，优先怀疑连接链路或拦截 | 确认代理配置，必要时在允许的测试网络复现 |
| 附件 | Zotero Storage/WebDAV、群组附件支持、文件下载状态 | 条目正常但附件异常，多半不是数据冲突 | 按文件同步路径单独处理 |
如果在不同网络下表现明显不同，可以记录网络类型、DNS设置、代理是否开启、错误出现时间和同步阶段。无实测数据时，不应把某个网络、线路或客户端宣称为必然更快；这些记录只用于定位连接问题。
常见问题 FAQ
1. Zotero 同步冲突应该选本地还是远程？
没有固定答案。选择前先比较本地、在线库和其他设备的关键字段、笔记及附件状态；本地版明确正确才保留本地，在线版明确正确才保留远程，两侧都有有效修改时逐项合并。无法判断时先备份，不要盲选覆盖。
2. 为什么我处理完冲突，下一次同步还会再次出现？
常见原因是没有点击 Next/Finish 完成冲突窗口，或者同步本身发生错误，导致选择结果没有保存。先确认窗口操作已完成，再查看同步图标旁的错误提示；如果仍重复出现，记录 Debug ID并按错误信息排查。官方重复冲突说明
3. PDF附件同步失败，能不能用解决条目冲突的方法处理？
通常不能。条目数据和附件文件属于不同同步范围。先确认附件同步方式、存储服务、群组库限制、代理和安全软件；只有条目字段出现两侧不同内容时，才使用条目冲突窗口。
4. 什么时候可以使用 Replace Online Library？
只有当在线库已经被错误修改，并且你有经过核对的正确本地数据库或备份时，才考虑使用。它会用本地库覆盖在线库，属于高风险的特殊操作，使用前必须停用自动同步并备份。官方重置说明
5. 同步冲突和同步失败有什么区别？
同步冲突是两侧都修改了同一条目，需要用户选择或合并；同步失败是同步过程本身没有成功，可能涉及账号、库设置、代理、网络、服务器响应或文件存储。冲突反复出现时，背后可能其实是同步失败。
处理完成后的检查清单
- 自动同步已按需要恢复，没有继续弹出未处理的冲突。
- Web Library、当前设备和其他设备的关键条目字段一致。
- 需要保留的笔记、标签和附件关联仍在。
- PDF附件能打开，或已明确处于下载队列而不是错误状态。
- 同步图标不再显示错误，必要时已经保存错误信息、Report ID或Debug ID。
- 如果执行过恢复或覆盖操作，已保留恢复前后的备份和操作记录。
本文依据本次核验到的 Zotero 官方文档整理；客户端菜单、按钮名称和网络环境可能变化，遇到界面不一致时以当前客户端显示为准。
常见问题
Zotero 同步冲突应该选本地还是远程？
先比较本地、在线库和其他设备的关键字段、笔记及附件状态。只有明确知道哪一侧正确时才选择保留；无法判断就先备份，不要盲目覆盖。
为什么处理完冲突后还会反复出现？
可能没有点击 Next/Finish，或者同步过程本身报错导致选择结果没有保存。查看同步图标旁的错误提示，并记录 Debug ID。
PDF附件同步失败也要打开冲突窗口吗？
通常不用。PDF属于文件同步范围，应单独检查 Zotero Storage、WebDAV、群组库限制、代理和网络连接。
什么时候可以使用 Replace Online Library？
仅在在线库已经被错误修改，且你有明确正确的本地数据库或备份时考虑。使用前应停用自动同步并备份。