External-DNS 中 CNAME 与 TXT 记录冲突问题分析与解决方案

问题背景

在 Kubernetes 集群中使用 External-DNS 管理 DNS 记录时，用户可能会遇到 CNAME 和 TXT 记录之间的冲突问题。这类问题通常表现为 AWS Route53 返回的错误信息："RRSet of type TXT/CNAME with DNS name... is not permitted because a conflicting RRSet... already exists"。

问题现象

当 External-DNS 尝试同时创建或更新 CNAME 记录和对应的 TXT 记录时，AWS Route53 会拒绝这些变更请求。错误信息主要分为两种形式：

1. CNAME 记录冲突：提示 "RRSet of type CNAME with DNS name... is not permitted as it conflicts with other records"
2. TXT 记录冲突：提示 "RRSet of type TXT with DNS name... is not permitted because a conflicting RRSet of type CNAME..."

根本原因

这个问题源于 DNS 协议本身的限制和 AWS Route53 的实现方式：

1. DNS 协议限制：根据 DNS RFC 标准，同一主机名不能同时存在 CNAME 记录和其他任何类型的记录（包括 TXT 记录）。

2. External-DNS 工作机制：External-DNS 默认会为每个 DNS 记录创建一个对应的 TXT 记录用于所有权验证和记录管理。当使用 CNAME 记录时，就会与这个 TXT 记录产生冲突。

3. 配置缺失：特别是当用户启用了 aws-prefer-cname 参数但未正确配置 TXT 记录前缀或后缀时，这种冲突更容易发生。

解决方案

方案一：禁用 CNAME 记录偏好

最简单的解决方案是移除 aws-prefer-cname 参数，让 External-DNS 默认创建 A 记录而不是 CNAME 记录：

# 在 Helm values.yaml 中
aws:
  preferCNAME: false  # 或直接移除该配置

这种方法避免了 CNAME 和 TXT 记录的冲突，但可能不适合所有场景，特别是需要使用 CNAME 记录的情况。

方案二：正确配置 TXT 记录前缀/后缀

如果必须使用 CNAME 记录，需要确保正确配置 TXT 记录的前缀或后缀：

# 在 Helm values.yaml 中
txtPrefix: "external-dns-"
# 或
txtSuffix: "-external-dns"

重要提示：Helm chart 中有一个特殊逻辑需要注意：

• 默认情况下，txtPrefix 被视为 null 而不是空字符串
• 只有当 txtPrefix 显式设置为空字符串时，txtSuffix 才会生效

因此，如果只想使用 txtSuffix，必须明确设置：

txtPrefix: ""
txtSuffix: "-external-dns"

方案三：升级到最新版本

某些版本（如 0.14.2）修复了与 CNAME/TXT 记录处理相关的 bug。确保使用最新稳定版本可以减少这类问题的发生。

最佳实践建议

1. 版本选择：始终使用 External-DNS 的最新稳定版本
2. 配置检查：部署前仔细检查 Helm values 配置，特别是与 TXT 记录相关的参数
3. 测试验证：在非生产环境先验证配置变更
4. 记录清理：遇到问题时，先手动清理冲突的 DNS 记录再重新部署
5. 监控告警：设置对 External-DNS 日志中错误信息的监控

总结

External-DNS 中 CNAME 和 TXT 记录冲突是常见但容易解决的问题。关键在于理解 DNS 协议的限制和 External-DNS 的工作机制，并根据实际需求选择合适的配置方案。通过合理配置 TXT 记录前缀/后缀或选择使用 A 记录，可以有效避免这类问题的发生。