Firebase Functions部署报错：Stripe未获取到API密钥或认证器

场景与依赖版本 #

这是一个集成Stripe与Firebase Functions的Web端Firebase应用，更新后的依赖版本如下：

"dependencies": {
  "stripe": "^17.2.0",
  "twitter-api-v2": "^1.18.0",
  "firebase-admin": "^12.4.0",
  "firebase-functions": "^6",
  "moment-timezone": "^0.5.45"
}

全局工具版本：firebase-tools@13.22.0

问题现象 #

此前应用运行正常，更新依赖后部署Firebase Functions时触发报错（疑惑为何不是仅运行时错误），错误信息：

Error: Neither apiKey nor config.authenticator provided
    at Stripe._setAuthenticator (C:\Users\webko\Documents\AppsAndWebsites\Node\robot\functions\node_modules\stripe\cjs\stripe.core.js:166:23)
    at new Stripe (C:\Users\webko\Documents\AppsAndWebsites\Node\robot\functions\node_modules\stripe\cjs\stripe.core.js:102:14)
    at Stripe (C:\Users\webko\Documents\AppsAndWebsites\Node\robot\functions\node_modules\stripe\cjs\stripe.core.js:58:20)
    at Object.<anonymous> (C:\Users\webko\Documents\AppsAndWebsites\Node\robot\functions\index.js:37:33)

报错指向代码行：

const stripe = require('stripe')(process.env.STRIPE_SECRET);

当前状态：

• 使用process.env.STRIPE_SECRET传递密钥触发报错
• 硬编码测试密钥字符串可正常运行
• 已确认密钥配置正确，执行firebase functions:secrets:access STRIPE_SECRET能正常显示密钥内容

疑问：为何更新依赖后，环境变量传递密钥的方式失效？

1. Firebase Functions v6的环境变量加载时机变化 #

Firebase Functions v6 对Secrets的加载逻辑做了关键调整：

• 旧版本中，process.env会在模块加载阶段自动注入Secrets
• v6版本中，Secrets默认仅在函数执行上下文内可用，模块初始化阶段（也就是你定义Stripe实例的时机）process.env.STRIPE_SECRET还未被注入，值为undefined，直接触发Stripe的参数校验报错。

解决办法 #

将Stripe实例的初始化移到函数内部，或者用onInit钩子提前加载：

// 方式1：移到函数执行上下文内
exports.yourStripeHandler = functions.https.onRequest(async (req, res) => {
  const stripe = require('stripe')(process.env.STRIPE_SECRET);
  // 后续业务逻辑
});

// 方式2：用onInit钩子预加载实例
let stripe;
functions.onInit(async () => {
  stripe = require('stripe')(process.env.STRIPE_SECRET);
});

exports.yourStripeHandler = functions.https.onRequest(async (req, res) => {
  // 直接使用预初始化的stripe实例
});

2. Stripe v17的参数校验更严格 #

Stripe v17 强化了实例化阶段的参数校验：

• 旧版本中，传入undefined可能会被忽略，直到实际发起请求时才报错
• v17版本在创建Stripe实例时就会直接检查API密钥是否存在，导致模块加载阶段就触发错误，这也是为什么现在部署时就报错，而非仅运行时。

3. 本地开发的环境变量验证 #

如果是本地部署测试，需确保：

• 执行firebase functions:secrets:set STRIPE_SECRET后，重启本地函数服务
• 本地调试时可添加临时日志验证变量值：

console.log('STRIPE_SECRET at module load:', process.env.STRIPE_SECRET);
const stripe = require('stripe')(process.env.STRIPE_SECRET);

如果输出undefined，即可确认是加载时机的问题。

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