QFieldCloud 同步失败：保护离线采集数据并核验上传结果

现场采集时遇到 QFieldCloud 同步失败，应先保护持有修改的设备，再考虑下载另一份项目。确认失败发生在上传变更、云端应用变更还是准备下载；这些阶段运行位置不同，需要不同处理方法。

关键要点：

• 权威数据中核验修改前，保留原始编辑项目。
• 变更上传成功，不代表变更已经应用。
• 手机网络对照不能修复云端工作进程的数据库连接。
• 应用成功后，在独立下载副本中检查已知记录。

QFieldCloud 同步失败时，先保护哪些数据？

结束当前编辑，按项目正常流程保存。记录设备、QField 版本、项目、失败图层和以后能够安全识别的记录标识。恢复协调期间，让协作者暂停修改项目结构；新结构可能影响待处理的离线编辑。

使用设备和项目支持的存储或导出方式做备份，确认包含相关本地项目与数据，而不只是桌面 .qgs 文件。如果不清楚待上传修改保存在哪里，先问项目管理员，不卸载 QField、不清应用存储，也不替换本地目录。

手机在其它应用中也无法联网时，可参考设备整体排障方法。本篇有更具体的边界：持有离线编辑的设备才是上传源。另一台电脑能打开 QFieldCloud，不证明手机上的修改已经传走。

观察结果	责任阶段	安全的下一项检查
云端没有出现新变更	设备上传或项目访问	原设备与上传结果
变更存在但待处理或失败	云端应用	变更状态与作业日志
打包失败	云端准备下载	打包作业和源数据可用性
另一副本缺少修改记录	已应用数据或下载新鲜度	记录标识和打包时间
多人修改同一要素	冲突解决	项目所有者的合并政策

步骤 1：怎样保留未同步编辑？

从原始设备开始，保持本地项目可访问。记录最新编辑及应一起传输的附件。使用有意义的记录编号或现有观察，不为测试网络向生产数据插入虚假要素。如果应用能显示修改后的值，在安全位置记录它，供后面比较。

不要一开始就删除项目并重新下载，这会改变你正在救回的副本，也可能丢失“缺少了什么”的证据。在待上传编辑和附件获得独立核验的备份前，同样不要清除应用数据或重装。

QFieldCloud 的离线编辑会为修改的要素生成变更，其它图层模式可能直接访问在线源，或把文件数据作为只读内容。检查实际图层动作；直接访问数据库的图层不自动属于本篇的离线变更保护流程。［1］

请所有者保留兼容的项目定义，直到各设备待处理修改完成协调。记录手机下载副本之后是否改过字段、图层或约束。旧结构即使在连接正常时也可能造成失败，不能靠反复发送相同编辑修复。

步骤 2：QFieldCloud 上传错误发生在哪个阶段？

确认开始的动作是推送编辑、同步还是下载项目。首次项目教程说明了从 QField 推送变更和同步，但界面中的笼统同步标签不一定指出具体失败阶段。记录实际操作及第一条错误。［2］

分别回答三个问题：手机是否送出了变更？云端是否把变更应用到原数据源？之后的下载包是否包含这些变更？逐项核验，不把进度条到达终点当成全部恢复。

使用有权限的账户查看项目的 Changes 与 Jobs 信息，在私有记录中保存相应标识。云端已有变更时，仅重试手机上传可能没有意义；云端没收到时，也要先确认项目与账户正确，不能直接判为传输失败。

云存储本地与远端副本检查解释了相邻问题。在这里，关键对象是 QField 变更、图层动作和云端作业，不能用泛泛的删除缓存或重新上传整个文件夹替代。

步骤 3：云端作业报告了什么？

QFieldCloud 区分项目处理、打包与应用增量。依据作业类型及结果选择处理者。项目处理成功不等于现场变更已经应用，打包失败也不一定表示手机上传失败。［3］

已有待处理作业时，先看状态，不反复按同一按钮。保留第一条有用错误和时间。云端工作进程访问数据库或其它源失败时，改变 Android 出口只改变设备连接，不会改变那个进程的出站路径。

冲突或不兼容图层定义需要项目所有者决定。不要覆盖他人要素，不在手机上重命名字段，也不在不知道应保留哪份修改时强制重新应用。保留本地证据与云端变更，直到确认接受的解决方案。

如果失败来自桌面准备项目，单独检查桌面连接。Windows 代理设置说明适用于 Windows 准备工作站，不适用于 Android 上传路由。修改桌面代理不能发送只存在于采集设备上的编辑。

步骤 4：原 Android 设备换路径后能上传吗？

只有证据指向设备到云端传输中断，并已确认账户与权限，才进入这一步。固定设备、项目、QField 版本和待上传变更，先记录日常获准连接的结果。对照期间不要增加新编辑。

检查手机连接稳定，本地存储足够完成正常流程。保持供电，让前台上传结束。手机休眠后停止上传，与服务器拒绝项目是不同观察，应记录发生条件，不把两者都称为互联网故障。

在持有离线工作的 Android 手机上，AethoVPN 可以为同一项目变更上传提供另一条出站路径。安装官方 Android APK，使用包含该移动设备的档位，选择获准的本国或附近可用位置，开启全局模式。返回 QField，重试原待上传任务，不下载覆盖本地副本。

可以核对这台手机浏览器的出口 IP，并按隧道验证步骤做辅助检查，然后确认云端是否接受了目标变更。隧道图标、不同 IP 或桌面上传成功都不证明手机的待处理编辑已到达。

替代路径不能解决云端工作进程失败、权限拒绝、冲突、结构不兼容或附件缺失。结果用于诊断，不承诺数据一定恢复。如果剩余分支是 Android 上传中断，可开始三天 Pro 免费试用对照这次传输；新用户每人仅一次。

手机原本已开 VPN 时，也应测试获准的普通连接。没有管理员指导，不叠加消费和组织隧道。服务器已经收到变更、转而报告应用错误时就停止换路，因为设备传输已不是失败阶段。

步骤 5：怎样核验 QField 项目同步结果？

先确认目标变更被接受，再确认应用成功且没有未解决冲突。在权威源或批准的视图中检查预期记录，使用原手机记录的相同标识和修改值；项目中出现另一条无关记录并不够。

确认应用成功后，才在另一台获准设备或独立核验副本中取得新项目包，检查已知记录的属性或几何。对照完成前保留原始编辑副本与备份；不要通过新下载覆盖唯一未同步工作。

任务包含附件时，单独核验。要素属性出现不代表照片或其它附件已经到达。准确记录缺失部分，让项目所有者判定剩余问题属于打包、存储、路径引用还是上传传输。

求助时通过批准的私有渠道提供 QField 版本、操作、脱敏的项目／变更／作业标识、时间、第一条错误和核验结果。公开帖子去掉凭据、个人位置和敏感现场观察。这是恢复流程，不是基准测试，也不表示所有 QFieldCloud 部署完全相同。

总结

• 替换文件前保留原始现场修改和已核验备份。
• 区分设备上传、云端应用与下载打包。
• 根据作业证据把故障交给正确负责人。
• 在实际持有修改的 Android 设备上比较路径。
• 在独立副本中核验已应用记录和附件。

常见问题

应该删除项目后重新下载吗？

项目还持有唯一待上传编辑时不要这样做。先保存并核验本地备份，确认云端已经收到和应用这些修改，再考虑替换工作副本。

桌面上传成功能证明手机同步了吗？

不能证明只保存在手机上的编辑已传输。必须跟踪原采集设备的变更，并用已知修改记录核验实际上传和云端应用结果。

云端变更条目能证明数据源更新了吗？

它说明云端有变更需要处理，不一定表示应用成功。检查变更结果和对应作业，再到权威数据中核对预期记录。［3］

为什么变更上传后，打包仍失败？

打包是云端阶段，准备图层或读取数据源时仍可能失败。应检查作业错误，不假设手机再换一个 VPN 位置就能修复工作进程的连接。［3］

这个流程覆盖直接访问的在线图层吗？

离线变更恢复步骤适用于配置为离线编辑的图层。直接访问采用不同数据路径，应先确认图层动作，再使用所有者规定的备份与编辑流程。［1］

现场编辑发生冲突应该怎么办？

保留证据，请项目所有者按约定合并政策处理。不要强制用自己的版本覆盖他人工作，也不要只为让待处理变更通过而修改结构。

什么时候可以停用旧本地副本？

目标变更成功应用并独立核验后才可以，包括所需附件。遵守项目保留流程，在所有者确认恢复完成前继续保留已核验备份。

来源

1. QField — QFieldCloud System Documentation
2. QField — My first project
3. QField — Jobs

Sources checked 2026 年 10 月 7 日。