跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

故障排除

最后更新 查看 MarkdownAgent 设置

如果您的证书卡在 Pending Validation 状态或签发失败,证书颁发机构 (CA) 可能无法完成域名控制验证 (DCV)。本页帮助您识别并解决常见的 DCV 问题。

快速检查清单

使用此检查清单识别常见的 DCV 问题:


验证 URL 被阻止

如果 HTTP DCV 出现问题,请检查以下设置:

  • 影响 /.well-known/* 的任何内容:检查 WAF 自定义规则、IP 访问规则 和其他配置规则,确保您的规则_不会_对验证 URL 启用交互式质询。

  • Workers 路由:如果您有匹配 */* 或包含 /.well-known/pki-validation/* 或 /.well-known/acme-challenge/* 路径的 Workers 路由,您的 Worker 可能会拦截来自证书颁发机构的 DCV 请求。请确保 Worker 要么将这些路径的请求透传,要么不匹配这些路径。这对于使用 Worker 作为回退源 的 Cloudflare for SaaS zone 尤其相关。

  • Cloudflare 账户设置 和 Page Rules(页面规则):检查您的账户设置、配置规则和 Page Rules,确保您未在验证 URL 上启用 Under Attack 模式。

重定向

启用 Always Use HTTPS 不会影响验证流程。

在部分 (CNAME) 设置中,如果您在源站侧管理令牌,请确保 /.well-known/* 路径上不会发生从 HTTP 到 HTTPS 的重定向。

使用重定向规则时,通过向规则添加条件,将 /.well-known/* 路径排除在重定向之外:

not starts_with(http.request.uri.path, "/.well-known/")

例如,如果您有一条将所有 HTTP 流量重定向到 HTTPS 的规则,请将规则表达式修改为:

(http.request.scheme eq "http") and not starts_with(http.request.uri.path, "/.well-known/")

DNS 设置和记录

以下错误指的是需要在权威 DNS 提供商处处理的情况:

  • the Certificate Authority had trouble performing a DNS lookup: dns problem: looking up caa for <hostname>: dnssec: bogus
  • Certificate authority encountered a SERVFAIL during DNS lookup, please check your DNS reachability.

排查时请考虑以下事项:

  • DNSSEC ↗ 必须正确配置。您可以使用 DNSViz ↗ 了解并排查 DNSSEC 部署问题。
  • HTTP 验证流程优先通过 IPv6 进行,因此如果存在任何 AAAA 记录且未指向与 A 记录相同的双栈位置,验证将失败。
  • 如果主机名或其父级存在 NS 记录,DNS 解析将由 NS 目标中定义的 DNS 提供商在外部管理。在这种情况下,您必须在外部 DNS 提供商处添加 DCV TXT 记录,或移除 Cloudflare 上的 NS 记录。

CAA 记录

  • 您的 CAA 记录 必须能从所有位置解析。
  • 您的 CAA 记录 应允许 Cloudflare 的合作证书颁发机构 (CA) 代表您签发证书。
  • 如果您使用子域名设置(subdomain.example.com),且 Cloudflare 不是父域名(example.com)的权威 DNS 提供商,您应确保父域名(example.com)具有允许 Cloudflare 合作 CA 的 CAA 记录,或完全没有 CAA 记录。

您可以通过运行以下命令检查 CAA 记录:

dig example.com CAA +short
Resolve-DnsName -Name example.com -Type CAA

过期或冲突的 DCV 记录

当 Cloudflare 为您处理 TXT 验证(完整设置或委托 DCV)时,Cloudflare 会在向证书颁发机构请求证书时添加 _acme-challenge TXT 记录。先前或已放弃的证书订单留下的记录可能仍然存在,并且可能不会显示在仪表板的 DNS > Records 下。

请检查以下症状:

  • 即使正确的 DCV 记录已就位,证书验证仍停留在 Pending Validation。
  • 您收到续期电子邮件,但添加 TXT 记录时返回 An identical record already exists,而您并未配置匹配的记录。
  • dig 返回您在 Cloudflare 仪表板中找不到的 _acme-challenge TXT 记录。
  • 您的 zone 使用委托 DCV,但证书颁发机构解析到的是过期的 _acme-challenge TXT 记录,而不是委托 CNAME。

要确认,请从权威 nameserver 查询该记录:

dig _acme-challenge.example.com TXT +short @<AUTHORITATIVE_NAMESERVER>

将 dig 返回的每个值与待验证证书所列的令牌进行比较(请参阅 Get DCV values)。如果某个值与这些令牌均不匹配,且您可以在 DNS 设置中找到该记录(在 DNS > Records 下,或在外部 DNS 提供商处),则应由您删除。如果某个值与这些令牌均不匹配,且您在 DNS 设置中找不到该记录,请联系 Cloudflare 支持,以移除过期记录。记录移除后,您可以向验证端点发送 PATCH 请求,并使用相同的 DCV 方法以触发重新验证。

证书颁发机构 (CA) 错误

证书颁发机构 (CA) 是为您签发 SSL/TLS 证书的组织。Cloudflare 与多个 CA 合作,为您的域名提供证书。

速率限制

如证书颁发机构中所述,特定 CA 可能有自己的限制。若您使用 Let's Encrypt 并收到以下错误,表示您已达到 Let's Encrypt 施加的重复证书限制 ↗。

The authority has rate limited these domains. Please wait for the rate limit to expire or try another authority.

若证书包含完全相同的主机名集合,则视为与先前证书的重复。

在这种情况下,您可以等待速率限制窗口结束,或选择其他证书颁发机构。

当您看到 The authority has rate limited these domains. Please wait for the rate limit to expire or try another authority 时,证书颁发机构因近期请求过多而暂时阻止了您域名的证书签发。

各 CA 的速率限制窗口不同:

解决方法:等待速率限制窗口过期,或选择不同的 CA。

CAA 记录阻止签发

错误 CAA records block issuance. Please remove all CAA records or add records for this authority 表示您域名的 CAA 记录 不允许所选证书颁发机构签发证书。

解决方法:从域名中移除所有 CAA 记录,或添加明确允许 Cloudflare 合作证书颁发机构 的 CAA 记录。

多视角验证错误

证书颁发机构从多个地理位置执行域名验证,以防止某些攻击。您可能会遇到以下错误之一:

  • Certificate authority encountered a multiple perspective CAA check error, please ensure your DNS is configured to allow CAA queries from all geographic perspectives
  • Certificate authority was unable to verify domain ownership from multiple geographic locations (MPIC failure). Please ensure your DNS records are reachable from all geographic perspectives and try again.

解决方法:确保您的 DNS 记录(包括 CAA 记录)在所有地理位置都能一致解析。您可以使用 ping.pe 工具 ↗ 调查解析错误。例如,对于 Google Trust Services 证书,请检查:<hostname>:CAA:8.8.8.8。

更多信息请参阅证书颁发机构文档:SSL.com ↗、Let's Encrypt ↗ 和 Google Trust Services ↗。

DNS 查找错误

错误 the Certificate Authority had trouble performing a DNS lookup 表示 CA 无法解析您域名的 DNS 记录。常见原因包括 SERVFAIL 响应、NXDOMAIN 或 DNSSEC 验证失败。

解决方法:验证 DNS 记录是否正确配置且可解析。使用 DNSViz ↗ 等工具检查 DNSSEC 问题,并确保权威 nameserver 正常响应。

标识符被拒绝

错误 The certificate authority will not issue for this domain. Please check your input or try another authority 表示 CA 有策略阻止为您的特定域名签发证书。

解决方法:验证域名拼写正确且不违反 CA 的签发策略。如果域名有效,请尝试选择不同的 CA。

内部错误

当您看到 Internal error with Certificate Authority. Please check later 时,证书颁发机构在验证过程中遇到了临时问题。

解决方法:等待几分钟后重试。如果问题仍然存在,请尝试选择不同的 CA。Cloudflare 将根据验证退避计划自动重试验证。


DCV 令牌值已更改

DCV 令牌由证书颁发机构 (CA) 生成,而不是由 Cloudflare 生成。如果您先前获取的令牌值不再被接受,可能是由于以下原因之一而发生了更改:

原因 详情
令牌过期 CA 令牌具有由 CA/B Baseline Requirements ↗ 定义的固定有效期。过期后,Cloudflare 会自动生成新令牌。
验证失败 如果 DCV 检查失败,当前令牌可能失效,Cloudflare 会生成替换令牌。发生此情况的时机请参阅 DCV tokens。

CA 令牌的有效期如下:

证书颁发机构 令牌有效期
Google Trust Services 14 天
Let's Encrypt 7 天
SSL.com 14 天

在过期和失败这两种情况下,令牌值都会更改。如果您手动管理 DCV,请始终在放置或更新 DNS 记录之前,通过 SSL Verification API 获取当前令牌值。请勿重复使用先前记下的令牌值。

要在放置记录后立即触发 DCV 重新检查——而不是等待 Cloudflare 的下一次计划尝试——请使用 Edit SSL Certificate Pack Validation Method 端点,并指定您当前使用的相同 validation_method。

完整重试计划和令牌有效期详情请参阅验证退避计划。


验证方法已更改为 TXT

如果您预期使用 HTTP DCV,但收到的是 TXT 令牌——或者您配置了 HTTP DCV,后来发现已更改为 TXT——则适用以下条件之一:

您的证书无法使用 HTTP DCV

某些证书配置无论您的偏好如何都不能使用 HTTP DCV:

  • 通配符主机名:ACME 证书颁发机构无法对通配符 SAN(例如 *.example.com)完成 HTTP DCV。任何包含通配符主机名的证书都使用基于 TXT 的 DCV。
  • China Network zone:启用了 China Network 的 zone——包括 JDCloud 广播的 zone——仅使用基于 TXT 的 DCV。这些 zone 无法使用 HTTP DCV。
  • Dedicated 证书:Dedicated 证书类型不支持 HTTP DCV。

已配置 HTTP DCV,但随时间回退到 TXT

如果您在部分 DNS 设置中使用 HTTP DCV 并手动管理 DCV 令牌,Cloudflare 会在 HTTP DCV 持续失败一段时间后回退到 TXT,该时间取决于证书有效期:

  • 90 天证书:失败 15 天后
  • 30 天证书:失败 7 天后
  • 14 天证书:失败 3 天后

回退发生后,Cloudflare 会生成您必须在权威 DNS 提供商处手动放置的 TXT 令牌。要了解 HTTP DCV 失败的原因,请参阅验证 URL 被阻止和重定向。

证书续期回退到 TXT

在证书续期时,无论初始签发使用何种方法,Cloudflare 始终先尝试 HTTP DCV。仅当满足以下全部条件时,续期才会通过 HTTP 自动完成:

  • 证书上的所有主机名都通过 Cloudflare 代理。
  • 所有主机名都解析到分配给该 zone 的 Cloudflare IP 地址。
  • 证书不包含通配符主机名。

如果任一条件未满足,续期将回退到您配置的方法,您必须手动放置新的 DCV 记录。续期令牌在证书过期前 30 天生成。

要在部分设置中避免手动续期步骤,请考虑使用委托 DCV,即使由您控制权威 DNS,Cloudflare 也可以代表您管理 DCV。

这篇文档对您有帮助吗?