求助：Google Cloud Functions 2nd Gen(Node.js22)日志无法在Cloud Logging显示

问题概况 #

在Firebase项目中使用Cloud Functions 2nd Gen（Node.js 22）时，console.log/console.error生成的应用日志无法在Cloud Logging的Log Explorer中显示，但HTTP、Cloud Run等系统日志正常。已尝试添加日志语句、重新部署、配置Logs Writer角色、检查筛选条件等操作，通过gcloud logging write能正常写入日志，说明Cloud Logging功能本身无问题。

可能原因与解决方法 #

1. 适配Node.js 22的结构化日志格式 #

Cloud Functions 2nd Gen基于Cloud Run，Node.js 22的默认console输出可能未被Cloud Logging正确解析。可以直接输出JSON格式的结构化日志，确保日志被识别：

console.log(JSON.stringify({
  severity: 'INFO',
  message: 'TEST LOG',
  timestamp: new Date().toISOString()
}));

也可以使用官方日志库@google-cloud/logging直接写入日志：

const { Logging } = require('@google-cloud/logging');
const logging = new Logging();
const log = logging.log('function-app-logs');

exports.yourFunction = async (req, res) => {
  const metadata = {
    resource: { 
      type: 'cloud_function', 
      labels: { 
        function_name: 'YOUR_FUNCTION_NAME', 
        region: 'YOUR_REGION' 
      } 
    },
    severity: 'INFO'
  };
  const entry = log.entry(metadata, 'TEST LOG');
  await log.write(entry);
  res.send('OK');
};

2. 配置强制启用日志的环境变量 #

部署时添加环境变量GOOGLE_CLOUD_LOGGING_ENABLED=true，避免日志被运行时抑制：
使用Firebase CLI部署：

firebase deploy --only functions:yourFunction --set-env-vars GOOGLE_CLOUD_LOGGING_ENABLED=true

或在firebase.json中配置：

{
  "functions": {
    "source": "functions",
    "runtime": "nodejs22",
    "env": {
      "GOOGLE_CLOUD_LOGGING_ENABLED": "true"
    }
  }
}

3. 验证运行服务账号的权限 #

确认函数的运行服务账号（格式：PROJECT_ID@appspot.gserviceaccount.com）已拥有roles/logging.logWriter角色：

• 进入Cloud Console的IAM页面
• 搜索该服务账号，检查权限列表
• 若缺失则添加角色，等待1-2分钟让权限生效

4. 调整Log Explorer的筛选条件 #

应用日志可能归类在stdout或stderr日志中，使用以下筛选器精准查找：

resource.type="cloud_run_revision"
AND (logName="projects/PROJECT_ID/logs/stdout" OR logName="projects/PROJECT_ID/logs/stderr")
AND resource.labels.service_name="YOUR_FUNCTION_NAME"

或使用更宽泛的筛选器覆盖所有相关日志：

resource.type="cloud_function" OR resource.type="cloud_run_revision"
AND resource.labels.function_name="YOUR_FUNCTION_NAME"

5. 确认函数已被正确触发 #

HTTP触发的函数需确认请求已发送，事件触发的函数需确认对应事件（如Firestore更新、Storage上传）已发生。可在函数执行详情页查看调用记录，确保函数确实被执行。

已知问题说明 #

目前Node.js 22在Cloud Functions 2nd Gen中的日志适配存在部分兼容性问题，Google官方正在优化。上述方法为当前可行的临时解决方案，后续版本更新后可能修复默认console日志不显示的问题。

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