QFieldCloud 同步失敗：保留離線採集修改並核驗上載

採集期間遇到 QFieldCloud 同步失敗，先保留持有修改的設備，不要急於下載另一份項目。查明是上載變更、雲端套用，還是準備下載失敗；各階段在不同位置執行，需要不同處理。

關鍵要點：

• 權威資料核驗完成前，保留原始編輯項目。
• 變更已上載，不等於已套用。
• 手機換路不能修復雲端工作程序的資料庫連接。
• 套用成功後，在獨立下載副本檢查已知記錄。

QFieldCloud 同步失敗時，先保護哪些資料？

完成手上編輯，按項目正常流程儲存。記錄設備、QField 版本、項目、受影響圖層，以及稍後可安全辨認的記錄標識。協調恢復時，請協作者暫停修改項目結構，避免新結構影響未處理離線工作。

使用設備及項目支援的儲存或匯出方法備份，核對相關本地項目與資料是否齊全，不要只保留桌面 .qgs。不清楚待傳修改儲存位置時，先問管理員，不卸載 QField、不清除程式儲存，也不替換本地資料夾。

手機在其它程式也連接失敗，可參考設備整體排障方法。這裏的關鍵是持有離線編輯的設備才是上載來源；另一部電腦能開啟 QFieldCloud，不代表修改已離開手機。

觀察	負責階段	安全檢查
雲端沒有新變更	設備上載或項目存取	原設備及上載結果
變更存在但待處理或失敗	雲端套用	變更狀態及作業紀錄
打包失敗	雲端下載準備	打包作業及來源可用性
另一副本缺少編輯記錄	已套用資料或下載新鮮度	記錄身份及打包時間
多人編輯同一要素	衝突處理	擁有人的合併政策

步驟 1：如何保留尚未同步的編輯？

從原設備開始，維持本地項目可用。記錄最新修改及應同行傳送的附件。用有意義的記錄 ID 或現有觀察，不為測網絡在正式資料插入虛構要素。程式仍顯示編輯值時，安全記下以供之後核對。

不要把刪除項目再下載當作首步；這會改變要救回的副本，並可能刪去缺失內容的證據。未完成待傳編輯與附件的獨立備份核驗前，同樣不要清除程式資料或重裝。

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 日。