Firebase Tools 项目中 Artifact Registry 清理策略的 Dry Run 模式问题分析

在 Firebase Tools 项目的最新版本 14.1.0 中，用户报告了一个关于 Artifact Registry 清理策略的有趣问题。当用户尝试为 Cloud Functions 容器镜像设置清理策略时，系统默认将策略应用为 Dry Run（试运行）模式，而非预期的 Delete artifacts（删除工件）模式。

这个问题最初由用户在三个不同项目中重复观察到，表明这不是偶发性的权限问题。通过深入分析，我们发现问题的根源在于 Artifact Registry API 的默认行为与 Firebase Tools 命令行工具的交互方式。

从技术实现角度来看，当 Firebase CLI 执行清理策略设置时，它会向 Artifact Registry 服务发送 PATCH 请求来更新仓库配置。然而，API 响应中返回的 cleanupPolicyDryRun 字段默认为 true，而 CLI 工具在后续更新操作中未能显式覆盖这个默认值。这导致尽管用户明确选择了删除策略，系统仍然保持试运行模式。

这个问题特别值得注意，因为它不会导致命令执行失败，而是静默地应用了与用户预期不同的配置。对于依赖自动清理来管理存储成本的项目来说，这种差异可能导致存储空间未被及时释放，从而产生不必要的费用。

开发者 Cole Rogers 通过分析调试日志快速定位了问题所在，并提出了修复方案。解决方案的核心是在更新清理策略时，显式设置 cleanupPolicyDryRun 为 false，确保策略按预期在删除模式下运行。

这个问题提醒我们，在与云服务 API 交互时，特别是涉及默认值和可选参数时，需要格外小心。作为最佳实践，工具应该明确设置所有相关参数，而不是依赖服务端的默认行为，这样可以避免类似的意外配置差异。

对于使用 Firebase Tools 管理 Cloud Functions 的用户来说，建议在设置清理策略后，通过 Google Cloud Console 验证策略的实际运行模式，确保配置符合预期。同时，关注工具的未来版本更新，以获取这个问题的官方修复。