如何在Google Cloud Functions中记录错误完整堆栈跟踪

直接在公共的BackendService层加全局错误拦截即可，不需要修改各个业务服务的调用代码，实现逻辑如下：

核心实现逻辑 #

Firebase 可调用云函数返回的错误对象本身携带了状态码、错误信息、自定义透传字段，你只需要在Observable流里加错误侧的tap操作，就能统一捕获所有经过这个服务的云函数调用错误，不会影响原有业务层的错误处理逻辑。
修改后的backend.service.ts代码：

import { Injectable } from '@angular/core';
import { AngularFireFunctions } from '@angular/fire/compat/functions';
import { tap } from 'rxjs/operators';

/**
 * Interface with the firebase backend.
 */
@Injectable({ providedIn: 'root' })
export class BackendService
{
  constructor(private _fns: AngularFireFunctions) { }

  /**
   * Call Firebase Cloud Function
   *
   * @param fName:  Function Name
   * @param params: Function Parameter Object
   */
  callFunction(fName: string, params: any) {
    const toCall = this._fns.httpsCallable(fName);

    return toCall(params).pipe(
      tap({
        error: (err) => {
          // 组装完整错误日志
          const logPayload = {
            callTarget: fName,
            inputParams: params,
            errorCode: err.code,
            errorMessage: err.message,
            // 优先取云函数端透传的堆栈，不存在则取客户端侧调用堆栈
            fullStackTrace: err.details?.stack || err.stack,
            timestamp: new Date().toISOString()
          };
          // 替换为你实际使用的日志上报逻辑，本地调试可直接打控制台
          console.error('[Backend Service Error]', logPayload);
        }
      })
    );
  }
}

字段说明 #

• err.code：对应云函数返回的HTTP状态映射值，比如permission-denied对应403、not-found对应404、internal对应500、unauthenticated对应401
• err.details：是云函数侧抛出错误时自定义传入的透传字段，要拿到云函数端的完整堆栈，需要你在云函数侧抛出错误时主动把堆栈放到这个字段里
• 原有业务层（比如示例中的RequestWithSettlementService）的调用逻辑、错误捕获逻辑完全不需要改动，拦截记录后错误会正常向下抛出，不影响业务逻辑

云函数侧适配 #

要拿到服务端的完整错误堆栈，云函数侧抛出错误时必须使用Firebase提供的HttpsError类型，不能直接抛出普通Error对象，否则自定义字段无法透传到客户端，示例写法：

// 云函数侧代码示例
import * as functions from 'firebase-functions';

export const writeProvision = functions.https.onCall(async (data, context) => {
  try {
    // 原有业务逻辑
  } catch (err) {
    throw new functions.https.HttpsError(
      'internal',
      '操作执行失败',
      // 把服务端堆栈放到details字段透传
      { stack: err instanceof Error ? err.stack : '未知错误' }
    );
  }
});

提示：生产环境建议对敏感参数做脱敏处理后再打日志，避免把密钥、用户隐私信息上报到日志系统。

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