域名故障排查

先从 CLI 开始，它会实时查询每条记录：

spacepost domains doctor acme.com

或者用 dig 手动比对：

dig +short CNAME a1b2c3d4e5f6._domainkey.acme.com
dig +short MX send.acme.com
dig +short TXT send.acme.com
dig +short TXT _dmarc.acme.com

域名一直停留在 pending 或 not_started

原因	解决方法
记录尚未创建，或 DNS 尚未生效	等待 10 到 30 分钟，然后调用 POST /domains/{id}/verify。TTL 为一小时或更长可能会延迟生效。
域名重复（a1b2._domainkey.acme.com.acme.com）	你的 DNS 服务商会自动追加域名；只需填写相对名称（a1b2._domainkey）。用 dig 检查。
名称缺少域名（a1b2._domainkey 无法解析）	你的服务商需要完整名称（a1b2._domainkey.acme.com），Route 53 中很常见。
Cloudflare 代理已开启	DKIM 的 CNAME 记录必须为 DNS only（灰色云朵），不能开启代理。
值中有多余的末尾点号或空白字符	请原样重新粘贴该值。
TXT 值带有引号	输入不带引号的值。
send 上存在冲突的现有记录	send.acme.com 上的 CNAME 不能与 MX/TXT 共存。请使用其他的自定义 Return-Path。
同一名称下有两条 SPF 记录	将它们合并为一个 TXT 值。每个名称只允许有一条 v=spf1 记录。

域名变为 failed

如果域名的 DNS 在 72 小时后仍未出现，SpacePost 就会放弃检查。请修复记录后再次调用 verify；状态会回到 pending，随后变为 verified。

invalid_from_address

403 invalid_from_address：“The example.com domain is not verified.”from 中的域名必须是你的团队下已验证的域名，或其子域名。请检查是否有拼写错误，以及是否使用了其他团队的 API 密钥。

Domain already registered

一个域名只能属于一个团队。如果你在离开旧团队后重新注册了域名，请先在旧团队中删除它，或联系支持。

Return path 已验证但 DMARC 失败

打开收到邮件的标头（Gmail：显示原始邮件），检查 Authentication-Results。理想情况是 dkim=pass header.d=acme.com，以及带有 smtp.mailfrom=send.acme.com 的 spf=pass。如果 SPF 显示的是 amazonses.com，说明 return path 记录缺失或尚未验证。

仍未解决

请发邮件至 support@spacepost.dev，并附上域名以及 spacepost domains doctor 的输出。