验证原因码
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_deliverable | SMTP RCPT 返回 250 OK——邮箱确认可投递。Microsoft 365 DBEB 模式确认投递时也会返回此原因码。 |
yahoo_api_verified | Yahoo 或 AOL 账号查询确认该账号存在。 |
microsoft_api_verified | Microsoft 个人账号查询(Outlook.com、Hotmail、Live、MSN)确认该账号存在。 |
unitedinternet_api_verified | GMX.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_found | SMTP 550/5xx 确认远程服务器上不存在该邮箱。 |
mailbox_disabled | 邮箱存在,但已被禁用或停用。 |
host_not_found | MX 主机名无响应——主机不可达或不存在。 |
yahoo_api_not_deliverable | Yahoo 或 AOL 账号查询确认该账号不存在。 |
microsoft_api_not_deliverable | Microsoft 个人账号查询确认该账号不存在。 |
unitedinternet_api_not_deliverable | GMX.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_deliverable | Catch-all 域名,且该具体地址的 RCPT 也返回了 250 OK。 |
catch_all_inferred | 根据缓存证据推断出 catch-all 状态(间接推断,并非实时探测)。 |
m365_internal_relay | Microsoft 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);
}