SST项目Vercel DNS记录创建失败问题分析与解决方案

在SST项目从v3.3.29升级到v3.4.28版本后，用户报告了一个关于Vercel DNS提供商无法正常创建DNS记录的问题。本文将深入分析该问题的原因，并提供详细的解决方案。

问题现象

当用户将SST项目从v3.3.29升级到v3.4.28版本后，尝试使用Vercel DNS提供商创建DNS记录时，系统会抛出以下错误信息：

Error creating DNS Record: Could not create DNS Record, unexpected error: invalid_value - Invalid record value: "0 issue amazonaws.com"

问题根源

经过技术团队深入调查，发现问题出在DNS记录值的格式处理上。具体来说，当系统尝试创建CAA记录时，记录值"0 issue amazonaws.com"缺少了必要的引号包裹。这是一个典型的格式验证问题，Vercel的DNS服务对输入值的格式要求非常严格。

影响范围

该问题首次出现在v3.4.8版本中，在v3.4.7及之前版本中工作正常。这意味着：

• 所有使用v3.4.8至v3.4.35版本的SST项目都会受到影响
• 仅影响使用Vercel作为DNS提供商的情况
• 主要影响CAA记录的创建

解决方案

SST团队已在v3.4.36版本中修复了该问题。修复方案是为DNS记录值添加了必要的引号包裹，确保符合Vercel服务的格式要求。

对于遇到此问题的用户，我们建议采取以下步骤：

1. 将SST升级到v3.4.36或更高版本
2. 如果暂时无法升级，可以回退到v3.4.7版本作为临时解决方案
3. 对于自定义DNS配置，确保所有记录值都正确使用引号包裹

技术细节

CAA(Certification Authority Authorization)记录是DNS系统中用于指定哪些证书颁发机构(CA)可以为域名颁发证书的安全机制。正确的CAA记录格式应该如下：

example.com. IN CAA 0 issue "amazonaws.com"

在问题版本中，系统生成的记录缺少了引号，导致Vercel服务拒绝接受该记录。

最佳实践

为避免类似问题，建议开发者在进行基础设施即代码(IaC)开发时：

1. 始终保持依赖项更新到最新稳定版本
2. 在升级前仔细阅读变更日志
3. 在开发环境中先测试升级
4. 对于关键基础设施组件，考虑实现自动化测试和验证

通过这次事件，我们再次认识到基础设施代码中细节处理的重要性，即使是看似简单的引号问题也可能导致整个部署流程失败。