APICloud 雲端數據同步至本地 SQLite：C# 控制台實現方案

架構概覽

APICloud 雲端 API → C# 控制台程序 → 本地 SQLite，定時/觸發雙向同步。

核心步驟

1. 雲端讀取：調用 APICloud REST API GET /mcm/api/className，帶 X-APICloud-AppId、X-APICloud-AppKey、簽名驗證。
2. 分頁處理：單次最多 1000 條，用 limit/skip 循環拉取全量。
3. JSON 反序列化：Newtonsoft.Json / System.Text.Json 映射到實體類。
4. 本地 Upsert：SQLite 無原生 UPSERT（3.24.0+ 支持 ON CONFLICT），採用 INSERT OR REPLACE 或 MERGE 邏輯。
5. 增量同步：記錄雲端 updatedAt 最大值 / 本地同步時間戳，下次只拉取變更。
6. 雙向衝突解決：「雲端勝」/「本地勝」/「最後寫入勝」按業務策略實現。

關鍵代碼片段

// 1. 請求雲端
var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-APICloud-AppId", appId);
client.DefaultRequestHeaders.Add("X-APICloud-AppKey", sign);
var json = await client.GetStringAsync($"https://d.apicloud.com/mcm/api/{table}?limit=1000&skip={skip}");

// 2. 反序列化
var list = JsonConvert.DeserializeObject<List<T>>(json);

// 3. 批量寫入 SQLite (使用事務)
using (var conn = new SQLiteConnection(connStr))
using (var cmd = conn.CreateCommand()) {
    cmd.CommandText = @"INSERT OR REPLACE INTO t (id, col1, col2, updated_at) VALUES (@id, @c1, @c2, @ut)";
    var pId = cmd.CreateParameter(); pId.ParameterName = "@id";
    // ... 添加參數
    foreach (var item in list) {
        pId.Value = item.Id; // 設置參數值
        cmd.ExecuteNonQuery();
    }
}

避坑指南

• APICloud 簽名算法：HMAC-SHA256(AppKey, AppId + "UZ" + timestamp)，時間戳需與服務器同步（誤差 < 10min）。
• SQLite 連接字符串啟用 Journal Mode=WAL 提升併發性能。
• 大量數據分批提交（每 500-1000 條一事務），避免內存/鎖升級問題。
• 異常重試策略：指數退避 + 最大重試 3 次，記錄失敗 ID 人工介入。

作者已用控制台程序跑通全流程，建議後續封裝為 Windows Service / Linux Systemd 定時任務，加入日誌監控與告警。