Firebase Auth onCreate事件中日志函数无输出问题排查

问题场景 #

在Firebase Cloud Functions中，functions.auth.user().onCreate()触发器已确认触发（控制台可见触发记录），但函数内的console.log()和functions.logger.log()均无日志输出，仅当代码抛出错误时才会显示日志内容；而functions.https.onRequest()触发器中的日志能正常输出。

相关代码如下：

Auth onCreate事件函数 #

const admin = require('firebase-admin')
const functions = require('firebase-functions/v1')
admin.initializeApp()

exports.authUserOncreate = functions.auth.user().onCreate(async (user) => {
    console.log("=== Console Log ===")
    functions.logger.log("=== Functions Logger Log ===")

    console.log(user)

    const db = admin.firestore()

    await db.collection('users').doc(user.uid).set({
        displayName: user.displayName,
        email: user.email
    })
})

HTTP事件函数 #

const admin = require('firebase-admin')
const functions = require('firebase-functions/v1')
admin.initializeApp()

exports.httpRequest = functions.https.onRequest((req, res) => {
    console.log("Console Log Statement");
    functions.logger.log("First line of function!")
})

package.json #

{
    "dependencies": {
        "firebase-functions": "^4.4.1",
        "firebase-admin": "^11.11.0"
    },
    "engines": {
        "node": "20"
    }
}

可能的原因及解决办法 #

1. 异步函数未正确返回Promise #

Firebase Cloud Functions的异步触发器（如onCreate）需要明确跟踪异步操作的完成状态，若函数未返回异步操作的Promise，Runtime可能在日志写入前就终止函数进程，导致日志丢失。

解决： 修改函数，返回异步操作的Promise，或通过try/catch明确处理流程：

exports.authUserOncreate = functions.auth.user().onCreate(async (user) => {
    try {
        console.log("=== Console Log ===")
        functions.logger.log("=== Functions Logger Log ===")
        console.log(user)

        const db = admin.firestore()
        // 返回写入操作的Promise，确保Runtime等待操作完成
        return db.collection('users').doc(user.uid).set({
            displayName: user.displayName,
            email: user.email
        })
    } catch (error) {
        functions.logger.error("用户创建事件处理失败", error)
        throw error // 抛出错误，确保Runtime记录错误日志
    }
})

2. 日志级别过滤限制 #

Firebase控制台的日志查看器可能默认过滤了低级别日志（如info），导致日志无法显示。

解决： 打开Firebase控制台的日志页面，点击顶部的级别筛选器，选择「所有级别」，或明确勾选info、debug级别。

3. Node.js版本与依赖兼容性 #

Node.js 20与firebase-functions@4.4.1可能存在兼容性问题，部分版本组合会导致日志输出异常。

解决：

• 升级firebase-functions到最新兼容Node.js 20的版本（如^4.9.0），执行npm install firebase-functions@latest
• 若问题仍存在，可尝试将Node.js版本降级到18（修改package.json中engines.node为18，重新部署）

4. 日志延迟或缓存 #

线上部署的Functions日志可能存在几分钟的延迟，若刚触发函数，可等待片刻再查看日志。

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