BillionVerify LogoBillionVerify

验证原因码

BillionVerify API 返回的全部验证原因码参考手册——每个原因码的含义及处理建议。

看看它是怎么用的

邮箱验证是如何工作的?一层一层讲清楚

邮箱验证如何工作,从语法检查到 SMTP:跟着一个地址走过决定其结果的九个层级。了解地址会在哪里提前停下、邮件服务器的回复如何解读、Catch-all 如何检测,以及每种结果的费用。

每条验证结果都包含一个 reason 字段,用于说明该邮箱为何得到当前状态。参考本文档可构建精准的过滤规则、诊断异常结果,并调整发送策略。

原因码的工作方式

reason 字段与 status 字段一同出现在所有验证响应中:

{
  "email": "user@example.com",
  "status": "valid",
  "reason": "smtp_deliverable"
}

原因码是稳定的字符串标识符,可直接用于过滤规则或下游条件逻辑。

各类邮箱的验证方式

得到哪个原因码,取决于收件方服务商允许以何种方式检测:

  • 企业域名(Google Workspace、Microsoft 365、自建邮件服务器)会针对具体邮箱做实时 SMTP RCPT 检测。检测时会先探测同一域名下的一个随机地址,因此 catch-all(全收)域名、Microsoft 365 内部中继,以及处于全收模式的安全网关,都会被报告为 catchall,而不是 valid。
  • Gmail 会做实时 SMTP RCPT 检测。
  • Yahoo、AOL、Outlook.com、Hotmail、Live 和 MSN 屏蔽 SMTP 验证,因此通过各服务商专属的账号查询来检测。这类结果返回 yahoo_api_* 或 microsoft_api_* 原因码,用于确认账号是否存在。
  • GMX、web.de、Mail.ru、Yandex 及其他区域服务商按各服务商专属的节奏验证。速率限制、灰名单和拒绝检测会带来更多 unknown 结果。
  • Apple iCloud、Proton 和 Tuta 不允许任何可靠的检测,其地址始终返回 unknown,原因码为 smtp_unverifiable。

无论原因码是什么,unknown 结果都不计费。

valid(有效)

status: "valid" 的邮箱经确认可投递。

原因码说明
smtp_deliverableSMTP RCPT 返回 250 OK——邮箱确认可投递。Microsoft 365 DBEB 模式确认投递时也会返回此原因码。
yahoo_api_verifiedYahoo 或 AOL 账号查询确认该账号存在。
microsoft_api_verifiedMicrosoft 个人账号查询(Outlook.com、Hotmail、Live、MSN)确认该账号存在。
unitedinternet_api_verifiedGMX.com / mail.com 账号查询确认该账号存在。

invalid(无效)

status: "invalid" 的邮箱应从名单中移除——无法投递。

原因码说明
invalid_syntax邮箱地址语法解析失败——本地部分或域名格式有误,或缺少 @。不计费。
no_mx_records域名没有 MX 记录(NXDOMAIN 或 MX 查询结果为空)。
null_mx域名发布了 null MX 记录(RFC 7505)——明确表示不接收任何邮件。
spf_reject_all域名没有 MX 记录,且 SPF 记录包含 -all——域名明确拒绝所有入站邮件。
mailbox_not_foundSMTP 550/5xx 确认远程服务器上不存在该邮箱。
mailbox_disabled邮箱存在,但已被禁用或停用。
host_not_foundMX 主机名无响应——主机不可达或不存在。
yahoo_api_not_deliverableYahoo 或 AOL 账号查询确认该账号不存在。
microsoft_api_not_deliverableMicrosoft 个人账号查询确认该账号不存在。
unitedinternet_api_not_deliverableGMX.com / mail.com 账号查询确认该账号不存在。

unknown(未知)

status: "unknown" 的邮箱无法得出确定结论。unknown 结果一律不计费。部分原因是临时性的(可重试),其余则属于结构性限制。

原因码可重试说明
smtp_unverifiable否该服务商不允许任何可靠的 SMTP 验证(Apple iCloud、Proton、Tuta)。
smtp_blocked否远程 SMTP 服务器明确屏蔽或封禁了连接。
smtp_eof_blocked是MX 服务器在发送 banner 之前就关闭了连接——通常是按 IP 的速率限制器或 fail2ban 规则所致。
smtp_timeout是SMTP 操作超时(上下文截止时间或取消)。
smtp_connection_failed是通用 SMTP 连接失败——没有更具体的分类命中。
smtp_rate_limited是远程 SMTP 服务器返回了速率限制响应(421、450、451 或超出消息数量限制)。
smtp_greylisted是检测到通用灰名单响应——延迟后可重试。
smtp_550_unclassified是服务器返回的 550 并不明确表示“用户不存在”,因此不判定为 invalid。
smtp_egress_unavailable是检测时没有可用于该服务商的验证出口。
smtp_egress_unselectable否没有任何验证出口被允许访问该服务商。
mimecast_greylist是Mimecast 专属灰名单 / 451 临时失败。
proofpoint_ad_lookup是Proofpoint AD 异步查询进行中(收件人验证时返回 421 4.1.1 临时失败)。
proofpoint_egress_listed否受 Proofpoint 保护的域名,目前不响应我们的检测。
policy_temp_fail是远程策略强制执行导致的通用 4xx 临时失败。
google_rate_limit是Google MX 返回了速率限制或临时拒绝响应。
google_dmarc_misalignment否域名 DMARC 配置不对齐——Google 按 DMARC 策略拒绝。
m365_ip_rep_block是Microsoft 365 因 IP 信誉问题拒绝连接(4.7.650 / 4.7.651 代码)。
tonline_egress_not_whitelisted否T-Online 只接受来自白名单发件方的检测,因此无法验证该邮箱。
mailbox_full否邮箱存在,但已超出配额(SMTP 452 或邮箱已满响应)。
dns_timeout是DNS 或 MX 查询超时——解析器的临时问题。
dns_lookup_error是DNS 查询失败,且不是 NXDOMAIN 错误(SERVFAIL、UDP 超时或解析器错误)。
dns_resolution_failed是因临时原因导致 DNS 解析失败。
yahoo_api_error是Yahoo / AOL 账号查询失败——通用错误。
yahoo_api_unavailable是Yahoo / AOL 账号查询不可用(批量级健康检查失败)。
yahoo_api_eof是Yahoo / AOL 账号查询返回提前 EOF——TCP/TLS 连接临时中断。
yahoo_api_rate_limited是Yahoo / AOL 账号查询被限速。
microsoft_api_error是Microsoft 个人账号查询失败或被限流。
microsoft_api_unavailable是Microsoft 个人账号查询不可用。
unitedinternet_api_error是GMX.com / mail.com 账号查询失败。
unitedinternet_api_unavailable否GMX.com / mail.com 账号查询在本次运行中不可用。
capacity_deferred是该服务商的验证容量已满,本次检测被推迟。
provider_capacity_exhausted否该服务商的容量在整个重试窗口(约两小时)内一直处于已满状态,因此任务结束时这些地址仍没有结论。
carrier_blocked否日本运营商域名(docomo.ne.jp、au.com 等)——运营商策略屏蔽 SMTP。
internal_verifier_error是未分类的内部验证器错误——临时故障。
rate_limited是邮箱在批量处理期间被限速(文件任务中 smtp_rate_limited 的别名)。
bucket_default_skip_smtp_unknown否账户级验证模式设置为跳过 SMTP——结果仅基于域名检查。
mx_only_verification_semaphore_timeout是SMTP 并发信号量超时——仅 MX 的兜底验证确认 MX 记录有效,但无法单独验证该邮箱。

catch-all(全收域名)

status: "catchall" 的邮箱属于接受所有地址邮件的域名,无法确认单个地址是否可投递。

原因码说明
catch_all_domain域名确认为 catch-all——随机 RCPT 探测被邮件服务器接受。
catch_all_deliverableCatch-all 域名,且该具体地址的 RCPT 也返回了 250 OK。
catch_all_inferred根据缓存证据推断出 catch-all 状态(间接推断,并非实时探测)。
m365_internal_relayMicrosoft 365 域名配置为内部中继——所有 RCPT 均被接受,但未逐个验证。
gateway_accept_all安全网关(Mimecast、Proofpoint 等)处于全收模式。
forwarding_alias邮件转发别名服务(SimpleLogin、Firefox Relay、Duck.com)。
yahoo_isp_accept_all托管在 Yahoo 邮件基础设施上的 ISP 域名(例如 att.net、sbcglobal.net、verizon.net)——服务商接受所有收件人,因此无法做到邮箱级检测。
region_consumer_accept_all已知接受所有入站邮件的区域个人邮箱域名(较早的结果)。
bucket_default_skip_smtp_catchall账户级验证模式设置为跳过 SMTP catch-all 检测。

role(角色邮箱)

status: "role" 的邮箱属于共享收件箱(例如 info@、support@、noreply@)。这类地址通常可投递,但互动率较低。

角色邮箱继承其底层 SMTP 检查的 reason——该状态没有专属原因码。例如,通过 SMTP 检测的角色邮箱会显示 reason: "smtp_deliverable"。

disposable(一次性邮箱)

status: "disposable" 的邮箱属于临时邮箱服务。接受这类邮箱通常会带来低质量的注册。

原因码说明
disposable_domain域名被列为已知的一次性 / 临时邮箱服务商。

risky(高风险,仅旧结果)

新的验证不再返回 status: "risky"。它唯一的来源——Spamhaus 域名黑名单检查——已于 2026-09-11 移除。在该日期之前生成的结果中,你仍可能看到 risky。

在这些旧结果中,risky 表示该地址多半可投递,但收件域名被 Spamhaus 收录为垃圾邮件、钓鱼、恶意软件或僵尸网络 C&C 活动来源。risk_reasons 数组说明具体原因:

risk_reasons 取值说明
spamhaus_dbl_spam该域名被收录为垃圾邮件来源。
spamhaus_dbl_phish该域名被收录为钓鱼域名。
spamhaus_dbl_malware该域名被收录为恶意软件分发域名。
spamhaus_dbl_botnet_cc该域名被收录为僵尸网络命令与控制基础设施。

按原因码过滤

结合 status 和 reason 可实现精准的名单分类。例如,仅保留因临时问题而处于 unknown 的邮箱:

function isRetryableUnknown(result) {
  const retryableReasons = new Set([
    'capacity_deferred', 'context_cancelled', 'dns_lookup_error',
    'dns_resolution_failed', 'dns_timeout', 'google_rate_limit',
    'internal_verifier_error', 'm365_ip_rep_block', 'microsoft_api_error',
    'microsoft_api_unavailable', 'mimecast_greylist',
    'mx_only_verification_semaphore_timeout', 'policy_temp_fail',
    'proofpoint_ad_lookup', 'rate_limited', 'smtp_550_unclassified',
    'smtp_connection_failed', 'smtp_egress_unavailable', 'smtp_eof_blocked',
    'smtp_greylisted', 'smtp_rate_check_failed', 'smtp_rate_limited',
    'smtp_rate_wait_failed', 'smtp_timeout', 'unitedinternet_api_error',
    'yahoo_api_eof', 'yahoo_api_error', 'yahoo_api_rate_limited',
    'yahoo_api_unavailable',
  ]);
  return result.status === 'unknown' && retryableReasons.has(result.reason);
}

On this page