必须继承 Rule 接口，因归属地查询需依赖注入 HttpClient 或 Cache，闭包无法序列化服务容器；须设超时重试、缓存前7位、API失败时返回true兜底，并支持离线号段库与多语言提示。
手机号归属地验证规则要继承 Rule 还是写闭包？
必须继承 Rule 接口。闭包规则无法在构造时注入服务（比如 HTTP 客户端或缓存），而归属地查询必然涉及外部 API 调用或数据库查询，需要依赖注入支持。
常见错误是直接在闭包里用 Http::get()，结果在队列任务中失败——因为闭包序列化后丢失了 Laravel 的服务容器上下文。
- 新建规则类：
php artisan make:rule PhoneNumberCarrierRule - 在
__construct()中接收HttpClient或Cache实例，别偷懒写成静态方法 - 确保
passes()方法返回布尔值，message()返回字符串（不要返回翻译键）
调用第三方 API 做归属地查询时怎么避免超时和限流？
运营商查询接口（如阿里云、腾讯云、或开源的 shouji.51240.com）普遍有频率限制，且响应不稳定。不加防护直接调用会导致表单提交卡顿甚至 500 错误。
- 用
Http::timeout(2)->retry(1, 500)控制超时与重试，别用默认无限等待 - 必须加缓存：查过的号码（前 7 位足够）用
Cache::remember('carrier_1391234', 3600, fn() => ...)存一小时 - 兜底逻辑很重要：API 不可用时，
passes()应返回true（弱验证），而不是抛异常中断流程 - 别在验证规则里做号码格式校验——那是
required|string|regex:/^1[3-9]\d{9}$/的事
如何让自定义规则支持本地号码库（离线查）？
有些项目要求完全离线、无外网依赖，就得预置号段库。但直接读 CSV 或 JSON 文件会拖慢每次验证，必须预处理。
- 把号段数据（如工信部公开的
mobile_prefix.csv）导入 MySQL，建联合索引：ALTER TABLE mobile_prefixes ADD INDEX idx_prefix_length (prefix, length); - 查的时候只取手机号前 7 位，用
whereRaw('? LIKE CONCAT(prefix, "%") AND LENGTH(?) = length', [$number, $number])精准匹配 - 如果坚持用文件，至少用 PHP 的
apcu_cache缓存解析结果，避免每次 fopen + fgetcsv - 注意：虚拟运营商号段（170/171/167）和物联网卡号（144/148）容易被主流库遗漏，得单独补全
validateWithBag() 和手动调用 $request->validate() 对规则的影响
在控制器里用 $request->validate() 是最稳妥的，能自动绑定错误到 session；但如果在 Service 类或 Command 里验证，就只能用 Validator::make()，此时自定义规则的 message() 必须返回纯字符串，不能依赖 trans() 函数——因为没有请求上下文，翻译器可能未初始化。
- 统一在
message()里写死提示，例如return '手机号所属运营商不在支持列表中'; - 若需多语言，改用
Lang::get('validation.carrier')并确保 lang 文件已加载 - 测试时别只测成功路径：mock 掉 HTTP 客户端，强制返回空响应或 429，确认规则不会崩
