如何在Firebase云函数中获取traceId以实现跨微服务传播？

方案一：直接获取GCP自动生成的traceId #

定时触发的Pub/Sub云函数会由GCP自动注入X_CLOUD_TRACE_CONTEXT环境变量，这个变量包含了日志里显示的traceId。无需依赖第三方trace工具，直接读取环境变量即可：

export const foobar = functions.region(REGION).runWith({ memory: '2GB' }).pubsub.schedule('*/15 * * * *').onRun(async (context) => {
  // 读取GCP自动注入的trace上下文
  const traceContext = process.env.X_CLOUD_TRACE_CONTEXT;
  if (traceContext) {
    // 拆分出traceId（格式为 traceId/spanId;o=1）
    const [traceId] = traceContext.split('/');
    console.log('获取到自动traceId:', traceId);
    
    // 传递给第二个服务时，直接使用完整的traceContext作为请求头
    const response = await fetch('https://your-second-service.example.com', {
      method: 'POST',
      headers: {
        'x-cloud-trace-context': traceContext,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ data: 'your-payload' })
    });
  }
});

为什么之前的trace工具失效？ #

GCP调度器在你的函数代码执行前就创建了根trace span，@google-cloud/trace-agent这类工具无法捕获到这个外部创建的根span，所以getCurrentRootSpan()会返回null。直接读取环境变量是最可靠的方式。

方案二：自定义traceId（替代自动生成的） #

如果自动traceId获取有问题，你可以自己生成符合GCP格式的traceId，并确保日志和服务调用都关联这个ID：

import { randomBytes } from 'crypto';

export const foobar = functions.region(REGION).runWith({ memory: '2GB' }).pubsub.schedule('*/15 * * * *').onRun(async (context) => {
  // 生成符合GCP标准的traceId：16字节转成32位十六进制字符串
  const customTraceId = randomBytes(16).toString('hex');
  // 构造标准的x-cloud-trace-context格式
  const traceContext = `${customTraceId}/1;o=1`;
  
  // 将自定义traceId注入日志元数据，让GCP日志浏览器能关联日志
  console.log(JSON.stringify({
    message: '开始执行定时任务',
    trace: `projects/${process.env.GCP_PROJECT}/traces/${customTraceId}`
  }));
  
  // 传递给第二个服务
  const response = await fetch('https://your-second-service.example.com', {
    method: 'POST',
    headers: {
      'x-cloud-trace-context': traceContext,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ data: 'your-payload' })
  });
});

注意事项 #

• 自定义traceId必须是32位十六进制字符串（16字节），才能和GCP Trace系统兼容。
• 通过trace字段注入日志后，GCP日志浏览器会自动将该日志关联到对应的trace记录中。

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