Firebase模拟器本地使用@google-cloud/logging失败求助

本地使用Firebase模拟器时，无法通过@google-cloud/logging库记录日志，但console.log()可正常输出到模拟器日志面板。该库部署到线上GCP环境后工作正常，仅本地模拟器存在问题。

调用log.write(entry)时收到以下警告，且无日志内容：

functions: Finished "us-central1-pubsubTriggeredFunction" in 4.393208ms
⚠ External network resource requested!
URL: "http://169.254.169.252/computeMetadata/v1/instance/zone"
Be careful, this may be a production service.

相关代码片段：
日志函数：

async function logExecutionInfos(severity, message, functionName,
    event = null, errCode = null, errBody = null) {
    const slash = '%2F';
    const logName = 'test{slash}first${slash}${globalStore.getFirstId()}';
    const log = logging.log(logName);

    const metadata = new Metadata(functionName, message, severity);
    const payload = new Payload();

    payload.setRideId(globalStore.getRideId());
    payload.setPubsubMessageId(globalStore.getMessageId());
    message ? payload.setMessage(message) : null;
    event   ? payload.setEvent(event) : null;
    errCode ? payload.setErrorCode(errCode) : null;
    errBody ? payload.setErrorBody(errBody) : null;

    const entry = log.entry(metadata.getMetadata(), payload.getPayload());
    log.write(entry);
}

服务账号配置：

// Path to your service account key file
const serviceAccountPath = path.join(__dirname, '../test-app-firebase-952e06254be0.json');
// Load the service account key file
const serviceAccount = require(serviceAccountPath);

admin.initializeApp({
    credential: admin.credential.cert(serviceAccount),
    serviceAccountId:  serviceAccount.client_email
});
const db = admin.firestore();
const logging = new Logging({
    projectId: serviceAccount.project_id,
    keyFilename: serviceAccountPath,
    credentials: {
        client_email: serviceAccount.client_email,
        private_key: serviceAccount.private_key
    },
});

核心原因 #

本地模拟器环境中，@google-cloud/logging默认会尝试访问GCP元数据服务器（169.254.169.252）获取身份信息，但模拟器无此服务，导致请求失败；同时该库直接调用GCP日志API，不会将日志转发到Firebase模拟器的日志面板（面板仅捕获console系列输出）。

1. 本地环境用console模拟日志输出（推荐） #

通过环境判断区分本地与线上，本地用console输出到模拟器面板，线上保留@google-cloud/logging调用：

async function logExecutionInfos(severity, message, functionName,
    event = null, errCode = null, errBody = null) {
    // 判断是否在Firebase模拟器环境
    if (process.env.FUNCTIONS_EMULATOR === 'true') {
        const logContent = {
            severity,
            functionName,
            rideId: globalStore.getRideId(),
            pubsubMessageId: globalStore.getMessageId(),
            message,
            event,
            errCode,
            errBody
        };
        // 根据日志级别匹配对应console方法
        switch(severity.toLowerCase()) {
            case 'error':
                console.error(logContent);
                break;
            case 'warn':
                console.warn(logContent);
                break;
            default:
                console.log(logContent);
        }
        return;
    }

    // 线上环境正常使用@google-cloud/logging
    const slash = '%2F';
    // 修正原代码模板字符串语法错误：{slash} → ${slash}
    const logName = `test${slash}first${slash}${globalStore.getFirstId()}`;
    const log = logging.log(logName);

    const metadata = new Metadata(functionName, message, severity);
    const payload = new Payload();

    payload.setRideId(globalStore.getRideId());
    payload.setPubsubMessageId(globalStore.getMessageId());
    message ? payload.setMessage(message) : null;
    event   ? payload.setEvent(event) : null;
    errCode ? payload.setErrorCode(errCode) : null;
    errBody ? payload.setErrorBody(errBody) : null;

    const entry = log.entry(metadata.getMetadata(), payload.getPayload());
    // 异步操作添加await，确保日志发送完成
    await log.write(entry);
}

2. 优化服务账号配置（若本地需直接调用GCP日志API） #

如果一定要本地直接发日志到GCP线上服务，需精简logging客户端配置（避免冗余参数冲突）：

const logging = new Logging({
    projectId: serviceAccount.project_id,
    keyFilename: serviceAccountPath,
});

同时确保：

• 服务账号拥有logging.logEntries.create权限
• 本地网络可正常访问GCP API（无代理/防火墙拦截）

• Firebase模拟器日志面板仅捕获console系列输出，@google-cloud/logging的API调用不会自动转发到面板。
• 异步操作必须添加await，避免函数提前结束导致日志发送失败。
• 原代码中logName的模板字符串语法错误（{slash}未用${}包裹），需修正否则线上也会出问题。

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