如何让部署脚本等待Firestore索引就绪后再继续执行？

有两种可靠的方案可以实现这个需求，核心思路都是轮询检查Firestore索引的状态，直到所有索引标记为READY后再执行后续部署步骤：

方案一：用Firebase CLI+Shell脚本轮询 #

Firebase CLI提供了firebase firestore:indexes命令可以查看索引状态，结合shell脚本就能实现自动等待：

1. 先执行初始部署提交索引变更
2. 循环调用CLI命令获取索引状态，直到所有索引就绪
3. 执行依赖索引的后续部署步骤

示例Shell脚本 #

#!/bin/bash

# 第一步：提交索引部署
echo "开始部署Firestore索引..."
firebase deploy --only firestore:indexes

# 第二步：轮询检查索引状态
echo "等待索引就绪..."
while true; do
    # 用jq解析JSON格式的索引状态，提取所有索引的state字段
    # 注意：需要提前安装jq工具（sudo apt install jq / brew install jq）
    INDEX_STATES=$(firebase firestore:indexes --format json | jq -r '.indexes[].state')
    
    # 检查是否存在非READY的状态
    if echo "$INDEX_STATES" | grep -qv "READY"; then
        echo "仍有索引未就绪，1分钟后重试..."
        sleep 60
    else
        echo "所有索引已就绪！"
        break
    fi
done

# 第三步：部署依赖索引的服务（比如云函数）
echo "开始部署依赖索引的代码..."
firebase deploy --only functions

方案二：用Firebase Admin SDK编写Node.js脚本 #

如果需要跨平台支持或者更灵活的逻辑，可以用Node.js结合Admin SDK实现：

示例Node.js脚本 #

const { initializeApp } = require('firebase-admin/app');
const { getFirestore } = require('firebase-admin/firestore');
const { execSync } = require('child_process');

// 初始化Admin SDK（确保本地已配置Firebase credentials）
initializeApp();
const firestore = getFirestore();

async function waitForIndexesReady() {
    const MAX_WAIT_MINUTES = 30;
    let elapsedMinutes = 0;

    while (elapsedMinutes < MAX_WAIT_MINUTES) {
        const indexes = await firestore.indexes().list();
        const allReady = indexes.every(index => index.state === 'READY');
        
        if (allReady) {
            console.log('✅ 所有索引已就绪');
            return;
        }

        elapsedMinutes += 1;
        console.log(`⏳ 等待索引中，已等待${elapsedMinutes}分钟，1分钟后重试...`);
        await new Promise(resolve => setTimeout(resolve, 60000));
    }

    throw new Error('❌ 索引等待超时，超过30分钟仍未就绪');
}

// 执行部署流程
(async () => {
    try {
        // 提交索引部署
        execSync('firebase deploy --only firestore:indexes', { stdio: 'inherit' });
        
        // 等待索引就绪
        await waitForIndexesReady();
        
        // 部署依赖代码
        execSync('firebase deploy --only functions', { stdio: 'inherit' });
    } catch (error) {
        console.error('部署失败:', error.message);
        process.exit(1);
    }
})();

注意事项 #

• 索引就绪时间可能受Firebase负载影响，建议设置合理的超时时间（比如30分钟），避免无限等待
• CI/CD环境中要确保Firebase CLI或Admin SDK拥有足够的权限（比如配置好服务账号密钥）
• 轮询间隔设置为1-2分钟即可，过于频繁的请求可能会触发API限流

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