Firebase Functions：onDocumentCreated在模拟器中重试未触发

我在Firebase中使用onDocumentCreated触发器配置了一个云函数，注意到存在retry布尔配置项，原本假设当函数抛出错误时会触发重试。于是编写了如下测试函数并在本地模拟器运行，但尽管日志中能看到错误信息，函数却始终仅触发一次，从未执行重试操作。请问是否存在我遗漏的其他配置？

测试代码：

export const testRetries = onDocumentCreated(
  {
    document: "/testing/{test}",
    retry: true,
  },
  async (event) => {
    console.log("testRetries");

    throw new Error("test error");
  }
);

问题原因及解决方案 #

• 本地模拟器不支持重试逻辑：Firebase本地模拟器目前不会模拟触发器的重试行为，该特性仅对部署到线上环境的云函数生效。本地运行时，函数报错后直接终止，不会触发重试。
• 线上环境的重试规则：即使部署到线上，重试也并非无条件触发。Firebase会根据错误类型判断是否可重试（如网络波动、服务临时不可用这类临时性错误会触发重试，而代码逻辑错误这类永久性错误不会），且遵循指数退避的重试策略。
• 验证部署配置：若线上环境仍无重试，需确认retry: true的配置在部署时未被遗漏或覆盖，确保云函数的触发器配置正确生效。

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