Firebase多环境部署报错：Stripe扩展不支持更改密钥

问题分析与解决方案 #

问题背景 #

在Vue/Firebase项目的Dev、Prod双环境中使用firestore-stripe-payments扩展时，扩展自动生成的firestore-stripe-payments.env文件中，Stripe API密钥路径带有随机4字符后缀：

STRIPE_API_KEY=projects/${param:PROJECT_NUMBER}/secrets/firestore-stripe-payments-STRIPE_API_KEY-xxxx/versions/latest

（其中Dev环境对应dddd、Prod环境对应pppp）

尝试在Google Secret Manager中创建统一名称的firestore-stripe-payments-STRIPE_API_KEY密钥以适配多环境时，触发报错：

Error: firestore-stripe-payments: Found 'projects/foo/secrets/firestore-stripe-payments-STRIPE_API_KEY/versions/latest' for secret param STRIPE_API_KEY, but this instance was previously using a different secret projects/fooo/secrets/firestore-stripe-payments-STRIPE_API_KEY-dddd.
Changing secrets is not supported. If you want to change the value of this secret, use a new version of projects/foo/secrets/firestore-stripe-payments-STRIPE_API_KEY-dddd.You can create a new version at https://console.cloud.google.com/security/secret-manager?project=fooo

核心限制 #

firestore-stripe-payments扩展安装时会绑定每个项目专属的带后缀密钥实例，不支持更换已绑定的密钥名称，仅允许通过更新密钥版本来修改密钥值，这是报错的根本原因。

适配多环境的正确方式 #

• 分别维护Dev、Prod环境各自的带后缀密钥：
  • Dev环境：保留firestore-stripe-payments-STRIPE_API_KEY-dddd，需要更新密钥值时，直接在Google Secret Manager中为该密钥创建新版本
  • Prod环境：保留firestore-stripe-payments-STRIPE_API_KEY-pppp，更新逻辑与Dev环境一致
• 若需跨环境统一密钥值：可以手动同步两个密钥的版本内容，或编写脚本实现自动化同步

合适的提问渠道 #

• Firebase官方社区：专注Firebase生态相关问题，有官方团队及资深开发者提供针对性解答
• Stripe开发者论坛：聚焦Stripe支付集成的技术细节与场景问题
• Stack Overflow：提问时标记firebase、stripe、google-secret-manager标签，覆盖全栈开发场景的通用性问题
• GitHub仓库：直接在firestore-stripe-payments扩展的官方GitHub仓库提交Issue，适用于扩展本身的BUG反馈或功能需求建议

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