Cloud FireStore添加数据报错：Cannot read property 'collection' of undefined

变量作用域覆盖是本次报错的核心原因，具体问题如下：

• 你已经在全局作用域通过const db = getFirestore()初始化了Firestore实例
• 但testAddData函数定义时设置了同名形参db，如果你调用该函数时没有主动传入db参数，函数内部作用域的db会被未赋值的形参覆盖，值为undefined，调用db.collection时自然触发该类型错误

• 确认你使用的firebase-admin版本≥10.0.0，你的引入语法是v10+版本的写法，低版本会导致getFirestore()返回undefined
• 如果是本地测试而非Cloud Functions线上环境运行，需要先配置服务账号凭证：设置环境变量GOOGLE_APPLICATION_CREDENTIALS为你的服务账号JSON密钥文件路径，否则初始化Admin SDK会失败，导致db实例为undefined

推荐直接删除testAddData的形参，直接使用全局初始化完成的db实例即可，修复后代码如下：

const { initializeApp, applicationDefault, cert } = require('firebase-admin/app');
const { getFirestore, Timestamp, FieldValue } = require('firebase-admin/firestore');

initializeApp();
const db = getFirestore();

// 移除形参db
async function testAddData() {
    const docRef = db.collection('users').doc('alovelace');
    await docRef.set({
        first: 'Ada',
        last: 'Lovelace',
        born: 1815
    });
    const aTuringRef = db.collection('users').doc('aturing');
    await aTuringRef.set({
        'first': 'Alan',
        'middle': 'Mathison',
        'last': 'Turing',
        'born': 1912
    });
}

module.exports = { testAddData };

如果你的业务场景需要传入db实例，调用函数时传入全局的db即可：testAddData(db)

修复后可先在函数内部打印db实例确认是否正常：

async function testAddData() {
    console.log(db) // 输出不为undefined则代表初始化正常
    // 后续业务逻辑
}

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