跳转至

「格式无效」不能是一个标签

用户问的

「识别不出来作为未知会不会更好?比如很多他位数不对?或者是根本没有这个开头的? 在这边是不是能筛选掉格式不对的?」

方向对 —— e164 === ''(规范化失败)这个信号已经落在每一行上,做筛选零数据层改动。 但直接按它筛会静默丢单。

病灶:一个信号,三类东西

src/utils/phone-format.ts 里规范化失败走 miss(iso2, source),而 source 有三类:

normalizeSource 实际含义 号码本身 iso2
unknown 国家没猜出来(号里没 +、商家 countryCode 也缺) 很可能完全有效 null
noise-shape 坐标残片守卫拦下的(4.1566 这类经纬度小数) 真噪音 null
*:invalid / *:empty-format / *:parse-error 猜出国家了但位数/区号在该国不存在 真的对不上 有值

实测(libphonenumber-js/max,node 里跑的):

无国家线索: 907-842-5201 / (907) 842-5201 / 907.842.5201 / 1-907-968-2248
             → ParseError: INVALID_COUNTRY → e164 空     ← 全是能打通的美国号
给 US 线索: 同样这几个 → +19078425201 ✅
给 US 线索: 06152 40009(德国号)→ INVALID → e164 空    ← 这个才是真的对不上

7 条里 6 条(86%)有效美国裸号会落进 e164 === ''。

⇒ 把它们和真噪音合并成一个「无效」标签,用户看到就跳过 —— 静默丢单, 比不做这个功能坏得多。三家独立调研(terra-dsh / dshf / mimo-pro)一致否掉合并方案。

🔴 为什么 iso2 不够

前两类的 iso2 都是 null(phone-format.ts 里都走 miss(null, …))。 只看 iso2 会把坐标残片归进「认不出国家」,而那条标签对用户说的是 「不是坏号,别跳过」 —— 等于劝他去拨一个经纬度残片。

⇒ PhoneListItem 新增 normalizeSource,把失败原因从 PhoneDisplayForm 带上来。

修

src/utils/phone-validity-view.ts(纯判据,可单元测):

  • isMalformedNumber —— 「号码对不上」,让用户敢跳过
  • isCountryUnresolved —— 「认不出国家」,让用户不敢跳过
  • 两个零输入筛选算子挂在「类型」列上

判据取补集(不是 unknown 且不是 empty)而不是枚举 :invalid 后缀 —— 后缀由 ${source}:${e.message} 拼出,libphonenumber 的 message 会随版本变 (TOO_SHORT / NOT_A_NUMBER / …),枚举它等于把判据绑在库的错误文案上。

元教训

🔴 一个「失败」信号在被拿来做筛选之前,必须先问它混了几类东西。

e164 === '' 看起来是个干净的布尔判据 —— 规范化成功/失败。 但「失败」的原因决定了用户该做什么,而那个原因被丢在下一层没带上来。

这类信号的共同形态:上游知道原因,下游只拿到结果。 PhoneDisplayForm.source 一直记着原因,只是 PhoneListItem 没带它。

⚠️ 同类:sourceInferred(0148-source-inferred-flag-order-dependent)是把 per-source 的属性压成行级布尔;这条是把 per-reason 的原因压成「成功/失败」。 都是把一个多值的东西压成布尔,然后在下游发现分不出来了。