Firebase可调用函数context.auth始终为undefined（UNAUTHENTICATED错误代码16）求助

我最近卡在一个Firebase可调用函数的认证问题上，折腾了好几天都没头绪，来求助大家！

问题核心 #

我的iOS SwiftUI客户端已经成功完成Firebase匿名认证（Auth.auth().currentUser确认非nil且有有效UID），但调用Node.js第二代可调用函数时，服务端函数的context.auth始终是undefined，直接触发UNAUTHENTICATED（错误代码16）。虽然函数确实被触发了，但第一步的auth检查就失败，完全没拿到客户端的认证状态。

我的环境配置 #

• 客户端：iOS SwiftUI，firebase-ios-sdk v11.15.0，已完成匿名认证
• 服务端：Node.js v20，第二代https.onCall Firebase云函数
• 函数部署区域：us-central1
• 认证方式：Firebase匿名认证

客户端Swift调用代码 #

// 代码位于async函数内部，调用前已通过日志确认currentUser非nil
do {
    let functions = Functions.functions(region: "us-central1")
    // 函数名称"generateRecipe"已反复确认正确
    let result = try await functions.httpsCallable("generateRecipe").call(["prompt": "test"])
    print("Success: \(result.data ?? "No data")")
} catch {
    // 这里稳定捕获到'UNAUTHENTICATED'（Code 16）错误
    print("Function call failed: \(error)")
}

服务端Node.js检查代码 #

// index.js
const functions = require('firebase-functions');
const admin = require('firebase-admin');
admin.initializeApp();

exports.generateRecipe = functions.https.onCall(async (data, context) => {
    // 这是函数的第一行检查，因为context.auth是undefined直接失败
    if (!context.auth) {
        console.log("Function rejected. Context.auth is:", context.auth);
        throw new functions.https.HttpsError(
            'unauthenticated',
            'This operation requires authentication.'
        );
    }
    // 后续业务逻辑从未被执行到
    return { success: true };
});

已经排查过的所有可能问题 #

我已经逐一排查并修复了所有常规配置错误，但问题依然存在：

• 项目基础设施：创建过多个全新Firebase项目；确认Firestore为原生模式并使用默认数据库；解决了所有初始部署障碍（App Engine异常、gcf-admin-robot错误）
• IAM与API权限：给函数服务账号授予了Editor和Cloud Run Admin角色；手动验证Identity Toolkit、Cloud Run等所有必要API均已启用
• 服务端部署：函数现在每次部署都显示成功；修复了所有语法/lint错误；通过正确配置环境变量解决了容器健康检查失败的问题
• 客户端环境：使用最新版Firebase SDK；用的是重新下载的正确GoogleService-Info.plist；多次清理本地环境（删除DerivedData、重置模拟器、重启Mac）

关键发现：问题出在平台侧 #

根据社区建议（特别感谢Doug Stevenson），我给客户端添加了更细致的日志，结果非常明确：

• 调用函数前的日志显示客户端处于已认证状态：✅ DOUG'S TEST PASSED: Calling function as authenticated user: w2cuWHjJnqPYMN7JUGFabIozlRp1
• 但同一调用立刻触发UNAUTHENTICATED错误
• Cloud Run底层日志显示：请求在到达我的函数代码之前，就被平台以401 "The request was not authorized to invoke this service"为由拒绝了——这说明是Firebase平台没有正确传递客户端的认证状态到函数context中

关于重复问题说明 #

我已经看过类似症状的提问，但我的情况本质不同：那些问题最终都归因于客户端配置错误（比如用错SDK、部署失败），而我已经解决了所有这类问题，现在可以确定问题出在Firebase平台的认证状态传递环节。

内容来源于stack exchange