Firebase+JS技术求助：set操作失败，提示值参数含undefined属性

我正在开发一个按日期向Firebase实时数据库插入数据的程序，其中updateSingle函数用于更新指定日期数据，但运行时出现错误。单独调用数据接口能返回正常数据，但函数内部获取到的data却为undefined。

相关代码 #

/** 更新单日数据库数据
 * @param {string} day - 格式为'YYYY-MM-DD'的日期字符串
 * @param {ApiManager} apiManager - 用于获取数据的ApiManager实例
*/
async updateSingle(day, apiManager) {
    idList.forEach(async id => {
        let reference = ref(this.db, `${day}/${id}`);
        let data = await apiManager.getDataApi(day, id, apiManager.season);
        console.log(data); // undefined
        set(reference, data);
    });
}

运行时错误信息 #

file:///c:/Users/xyz/node_modules/@firebase/database/dist/node-esm/index.node.esm.js:10636
        throw new Error(errorPrefix + 'contains undefined ' + validationPathToErrorString(path));
              ^

Error: set failed: value argument contains undefined in property '2023-02-23.848'
    at validateFirebaseData (file:///c:/Users/xyz/node_modules/@firebase/database/dist/node-esm/index.node.esm.js:10636:15)
    at validateFirebaseDataArg (file:///c:/Users/xyz/node_modules/@firebase/database/dist/node-esm/index.node.esm.js:10628:5)
    at set (file:///c:/Users/xyz/node_modules/@firebase/database/dist/node-esm/index.node.esm.js:12794:5)
    at file:///c:/Users/xyz/src/firebase_manager.js:30:13
    at processTicksAndRejections (node:internal/process/task_queues:96:5)

单独调用getDataApi返回的数据格式 #

[
  {
    "fixture": {
      "id": 971801,
      "referee": "Istvan Kovacs, Romania",
      "timezone": "UTC",
      "date": "2023-02-21T20:00:00+00:00",
      "timestamp": 1677009600,
      "periods": {},
      "venue": {},
      "status": {}
    },
    "league": {
      "id": 2,
      "name": "UEFA Champions League",
      "country": "World",
      "logo": "https://media-3.api-sports.io/football/leagues/2.png",
      "flag": null,
      "season": 2022,
      "round": "Round of 16"
    },
    "teams": { "home": {}, "away": {} },
    "goals": { "home": 2, "away": 5 },
    "score": {
      "halftime": {},
      "fulltime": {},
      "extratime": {},
      "penalty": {}
    }
  },
  {
    "fixture": {
      "id": 971803,
      "referee": "Artur Soares Dias, Portugal",
      "timezone": "UTC",
      "date": "2023-02-21T20:00:00+00:00",
      "timestamp": 1677009600,
      "periods": {},
      "venue": {},
      "status": {}
    },
    "league": {
      "id": 2,
      "name": "UEFA Champions League",
      "country": "World",
      "logo": "https://media-3.api-sports.io/football/leagues/2.png",
      "flag": null,
      "season": 2022,
      "round": "Round of 16"
    },
    "teams": { "home": {}, "away": {} },
    "goals": { "home": 0, "away": 2 },
    "score": {
      "halftime": {},
      "fulltime": {},
      "extratime": {},
      "penalty": {}
    }
  }
]

问题原因分析及解决方案 #

核心原因 #

1. forEach不兼容async/await：forEach循环不会等待内部的异步操作完成，会直接遍历完所有id，导致set可能在data还未获取到的时候就执行，同时异步错误无法被外层捕获。
2. API调用未做错误处理：如果getDataApi调用失败（比如网络波动、API权限过期、部分id无对应数据），会直接返回undefined，且错误未被捕获，最终传递给set触发Firebase的数据校验错误。
3. 依赖版本变更：数月前正常运行现在出错，可能是Firebase SDK版本更新，数据校验规则变得更严格，之前允许的undefined值现在被拦截。

修复方案 #

把forEach替换为支持async/await的for...of循环，并添加错误捕获和数据校验：

async updateSingle(day, apiManager) {
    for (const id of idList) {
        try {
            let reference = ref(this.db, `${day}/${id}`);
            let data = await apiManager.getDataApi(day, id, apiManager.season);
            
            // 校验数据是否存在
            if (!data) {
                console.warn(`无数据返回：日期${day}，ID${id}`);
                continue;
            }
            
            console.log(data);
            set(reference, data);
        } catch (error) {
            console.error(`更新失败：日期${day}，ID${id}`, error);
        }
    }
}

同时建议：

• 检查getDataApi的调用参数是否完全正确，尤其是apiManager.season是否为有效值
• 验证所有idList中的id在指定日期是否有对应数据，排除无数据场景
• 核对Firebase SDK等依赖版本，确认是否有破坏性更新

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