GitHub Actions中Firestore模拟器无法清理数据求助

1. 确认模拟器监听地址 #

• 检查Firestore模拟器启动配置，确保它监听0.0.0.0而非仅localhost或::1。GitHub Actions runner环境中，模拟器可能绑定到特定网卡，导致仅本地回环地址无法访问。
• 修改启动命令，添加--host 0.0.0.0参数：firebase emulators:start --only firestore --host 0.0.0.0

2. 验证端口配置一致性 #

• 核对清理API调用的端口是否与模拟器实际监听端口匹配。Firestore模拟器默认端口为8080，若你配置了自定义端口9080，需确认启动日志中显示的监听端口确实是9080。
• 在GitHub Actions步骤中添加端口检查命令，比如lsof -i :9080或netstat -tulpn | grep 9080，确认模拟器进程在监听目标端口。

3. 调整清理操作的执行时机 #

• 测试结束后调用清理API时，模拟器可能已被提前终止。确保清理操作在模拟器进程仍运行时触发，比如放在测试脚本的teardown阶段，而非工作流最后一步（此时模拟器可能已被kill）。
• 可在清理前添加状态检查逻辑，比如用curl尝试连接端口，确认可用后再执行清理请求。

4. 排查runner环境网络限制 #

• 部分GitHub Actions环境可能限制本地回环地址访问，尝试用runner内部主机名或模拟器容器IP（若用Docker运行模拟器）发送清理请求。
• 若使用Docker运行模拟器，确保容器端口映射正确，清理请求发送到容器暴露的端口。

5. 优化fetch请求配置 #

• 超时问题可能源于未设置合理超时时间，或模拟器清理操作耗时较长。给fetch请求添加超时配置：

  fetch('http://127.0.0.1:9080/emulator/v1/projects/{PROJECT_ID}/databases/(default)/documents', {
    method: 'DELETE',
    signal: AbortSignal.timeout(10000) // 设置10秒超时
  })
  

• 同时确认请求路径中的{PROJECT_ID}已替换为实际测试项目ID。

6. 分析模拟器日志 #

• 在GitHub Actions中输出Firestore模拟器完整日志，检查是否有连接错误或清理请求记录。启动模拟器时添加--debug参数，获取更详细的调试信息，定位问题环节。

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