Remote Config JSON新增键值对后客户端默认值失效问题求助

核心原因 #

客户端加载Remote Config时，会优先使用本地缓存的旧JSON对象，而新的默认JSON仅在首次初始化或缓存失效时才会参与合并，导致新增的键值对在缓存未更新时无法从默认配置中读取。

直接解决方案：确保默认配置优先兜底 #

1. 手动合并默认JSON与远程JSON #

不要直接使用Remote Config返回的完整JSON对象，而是在客户端代码中做深层合并：将远程返回的缓存JSON（可能是旧的）和本地硬编码的新默认JSON进行合并，新的键值对以默认JSON为准兜底。

示例伪代码：

// 本地硬编码的最新默认JSON
const defaultAppTexts = {
  "welcome_msg": "欢迎使用",
  // 新增的键值对
  "new_feature_tip": "试试新功能"
};

// 从Remote Config获取的缓存JSON（可能是旧的）
const remoteAppTexts = remoteConfig.getValue("app_texts").asJSON();

// 深层合并：远程有值则用远程，无值则取默认
const mergedTexts = deepMerge(defaultAppTexts, remoteAppTexts);

// 使用合并后的对象，不会返回null
const newTip = mergedTexts.new_feature_tip;

需要实现一个deepMerge深层合并函数，确保嵌套结构也能正确合并，避免浅覆盖导致的配置丢失。

2. 针对性刷新缓存（谨慎使用） #

如果需要客户端尽快获取最新配置，可以在App启动或特定场景下，调用Remote Config的强制刷新方法，跳过缓存直接请求远程配置。注意不要频繁调用，避免影响性能或触发限流。

示例伪代码（以Firebase Remote Config为例）：

// Android示例：强制刷新，限制频率避免过度请求
remoteConfig.fetchAndActivate()
  .addOnCompleteListener { task ->
    if (task.isSuccessful) {
      val isUpdated = task.result
      // 刷新成功后使用最新配置
    } else {
      // 刷新失败，直接使用本地默认配置
    }
  }

可以临时将缓存过期时间设为0，等大部分客户端完成更新后再恢复正常过期时间。

长期优化方案 #

1. 拆分大JSON为独立配置项 #

不要把所有应用文本塞进一个大JSON对象，而是将每个文本项设为单独的Remote Config键值对。这样新增文本时，只是新增一个独立配置项，客户端读取时即便其他配置有缓存，新键值对会自动 fallback到默认值，不会因为整个JSON缓存导致失效。

比如将原来的app_texts大JSON拆分为：

• text_welcome_msg："欢迎使用"
• text_new_feature_tip："试试新功能"

客户端读取时直接调用：

// iOS示例
let newTip = remoteConfig.configValue(forKey: "text_new_feature_tip").stringValue ?? "试试新功能"

2. 版本化默认配置 #

在客户端默认配置中加入版本号，当检测到本地默认配置版本高于缓存的远程配置版本时，强制使用默认配置并触发刷新。

示例：

// 默认配置带版本号
const defaultConfig = {
  version: 2,
  texts: {
    "welcome_msg": "欢迎使用",
    "new_feature_tip": "试试新功能"
  }
};

const remoteConfigData = remoteConfig.getValue("app_config").asJSON();

if (!remoteConfigData || remoteConfigData.version < defaultConfig.version) {
  // 远程配置版本过旧，使用默认配置并触发刷新
  useConfig(defaultConfig);
  remoteConfig.fetchAndActivate();
} else {
  useConfig(remoteConfigData);
}

内容的提问来源于stack exchange，提问作者DJSjr