手机认证因配置原因失败时，不要让注册流程把号码当作无效

问题：看起来像用户错误的平台错误

在这个公开问题里，失败来自应用签名配置，而不是电话号码。用户输入了完全正确的号码，却依然无法完成注册。对你的应用来说，风险在于处理程序把所有非成功结果都映射为“电话无效”并拒绝注册，或者无限重试。两者都不对。配置错误对号码、归属或可达性没有任何说明。你要决定的是：如何分流那些既非干净通过、也未被证明无效的结果。夹具提供了具名分支，让你在本地练习这一决策，只需 Python 3.10 及以上版本，无需凭据，也没有网络调用。

夹具实际实现了什么

已实现行为：phone 函数接收一个分支（normal、unknown、provider_failure、otp），返回 mode、branch、otp_sent、live_line_type_available、state、valid、line_type 和 next。它不发送任何内容，不调用任何服务商，也不验证签名。所有分支都返回 mode 为 synthetic_fixture、otp_sent 为 false、live_line_type_available 为 false。其他任何分支都会抛出 UNSUPPORTED_FIXTURE。预期输出：normal 返回 state simulated、valid true、line_type mobile、next continue_customer_policy；unknown 返回 state unknown、valid null、line_type null、next review_or_existing_otp；provider_failure 返回 state unknown、valid null、line_type null、next bounded_retry_then_review；otp 返回 state unsupported、valid null、line_type null、next customer_otp_provider。其中 mobile 是合成值；当前免费生产路由不请求线路类型、归属、可达性或验证码投递。

假设场景：如何归类签名失败

假设场景：某小团队的 Android 注册流程调用其现有的 OTP 服务商，服务商以类似公开问题中的应用指纹错误拒绝了请求。以下是建议的应用设计，并非夹具行为：你的适配器把该响应归类为服务商失败，并用 provider_failure 分支进行演练。夹具的预期输出是 state unknown、valid null、next bounded_retry_then_review。随后你的代码以少量、固定的次数重试，为工程师记录错误类别，并把这次注册转入人工审核，而不是拒绝。由于 valid 是 null 而不是 false，用户永远不会被告知号码有误。配置错误通常不会因重试而消失，因此重试上限很重要：在注册等待审核期间，团队应修正签名配置。

由你的代码负责的失败处理

夹具只给出下一步的名称，你的应用必须自己实现。建议规则：把 valid null 视为“没有结论”，绝不视为拒绝；限制 provider_failure 的重试次数，并对重复出现的配置错误发出告警；对 unknown，提供审核或你已在使用的 OTP；对 otp，next customer_otp_provider 表示必须由你自己的服务商发送验证码，夹具报告 otp_sent false，从不发送消息；像夹具对 UNSUPPORTED_FIXTURE 的处理那样，显式拒绝意外分支。请把这个电话流程与身份夹具中的本地权限记录和合成回调分开：那些只是夹具数据，不是真实的业务权限；其 recover 步骤只在本地让会话过期，不会轮询任何服务商。

验收清单

在提交沙盒请求之前，请确认：四个分支都能运行，且与上述输出一致；当 valid 为 null 时，处理程序从不拒绝；provider_failure 的重试有上限，并以审核结束；配置错误与用户输入错误分开记录；otp_sent false 从不被显示为“验证码已发送”；live_line_type_available false 会阻止任何依赖线路类型的逻辑；不受支持的分支会明显地失败。然后用指南中的 unittest 命令运行工程测试。这些测试覆盖的是模拟状态转换，而不是生产环境的成功。真实路由是否可用需要另行确认；符合条件的企业可以自助登记免费的 Basic Lookup，技术限速为每分钟 60 次请求，但它同样不返回线路类型或号码归属。

运行已检查的模拟示例

下载并解压 https://gridzen.ai/downloads/verification-delivery.zip，进入 verification_delivery，用 Python 3.10+ 运行。此本地示例不联网；独立身份实验请使用新的数据库。

python3 delivery.py phone --branch unknown
python3 delivery.py phone --branch provider_failure

来源与范围

https://gridzen.ai/guides/signup-phone-check/ https://gridzen.ai/guides/current-capabilities/ 依据已检查的来源快照与本地模拟；建议的业务规则属于设计建议，不代表已证明的生产行为。内容使用 AI 辅助写作，并经过独立审稿。