使用Firebase CLI本地安装扩展时出现「Ref does not have a version」错误

DevOps 小满

2026-8-17

解决「Error: Ref does not have a version」问题

针对本地安装stripe/firestore-stripe-payments扩展时出现的版本错误，试试以下几种方案：

指定扩展版本安装
直接安装时未指定版本可能导致工具无法解析，尝试带具体版本号的命令（替换为当前最新稳定版本，比如1.3.0）：
```
firebase ext:install stripe/firestore-stripe-payments@1.3.0
```
更新firebase-tools到最新版本
你使用的11.x版本可能存在兼容性问题，先更新工具：
```
npm install -g firebase-tools
```
更新完成后再重新执行扩展安装命令。

手动添加扩展配置到firebase.json
如果命令行安装始终失败，可以参考Firebase Console中已安装的扩展配置，手动在firebase.json里添加extensions字段：

"extensions": {
  "firestore-stripe-payments": {
    "name": "firestore-stripe-payments",
    "source": "stripe/firestore-stripe-payments",
    "version": "1.3.0",
    "parameters": {
      "stripeApiKey": "sk_test_你的测试密钥",
      "stripeWebhookSecret": "whsec_你的Webhook密钥",
      "customersCollection": "customers",
      "productsCollection": "products",
      "enableLogging": "true"
    },
    "emulators": {
      "firestore": {
        "port": 8080
      },
      "functions": {
        "port": 5001
      }
    }
  }
}

添加后运行firebase ext:emulators:start启动扩展模拟器，配合本地其他模拟器使用。

重置firebase工具状态
尝试登出并重新登录Firebase，清除可能的缓存问题：
```
firebase logout
firebase login
```
若仍无效，可清除npm缓存后重装firebase-tools：
```
npm cache clean --force
npm install -g firebase-tools
```