Android 客戶端新增收貨地址後數據不同步問題排查

問題現象

Android 應用中，用戶新增收貨地址提交服務器後，重新請求地址列表介面，有時能獲取到新數據，有時獲取不到，表現為數據同步延遲或不一致。

可能原因分析

1. 服務端數據庫寫入延遲

• 主從數據庫同步延遲（讀寫分離架構常見）
• 事務提交未完成即返回成功響應
• 緩存未及時失效或更新

2. 客戶端請求時機問題

• 提交成功回調中立即發起查詢，服務端尚未完成數據持久化
• 缺乏適當的重試機制或輪詢策略

3. 網絡/併發問題

• 並發請求導致讀取到舊數據快照
• CDN 或代理緩存未刷新

解決方案

方案一：服務端強一致性保證（推薦）

// 服務端代碼示例（偽代碼）
@Transactional
public Address saveAddress(Address address) {
    addressDao.insert(address);
    // 強制刷新緩存或讀取主庫
    cacheService.evict("address_list_" + userId);
    return addressDao.findById(address.getId()); // 返回最新數據
}

方案二：客戶端樂觀重試機制

// Android 客戶端 Kotlin 協程示例
suspend fun refreshAddressListWithRetry(maxRetries: Int = 3, delayMs: Long = 500) {
    repeat(maxRetries) { attempt ->
        val addresses = api.getAddressList().await()
        if (addresses.any { it.isNewlyAdded }) {
            updateUI(addresses)
            return
        }
        if (attempt < maxRetries - 1) delay(delayMs * (attempt + 1))
    }
    // 最後一次嘗試仍失敗，提示用戶手動刷新
    showManualRefreshHint()
}

方案三：提交接口返回新數據

修改新增地址接口，直接返回包含新地址的完整列表，避免額外查詢請求。

調試建議

1. 在服務端添加日誌記錄寫入時間和查詢時間
2. 使用抓包工具（如 Charles）對比請求響應時間線
3. 檢查數據庫主從同步延遲監控指標
4. 驗證 iOS 端是否使用了不同的 API 版本或緩存策略