调用Twilio API向无效固话发消息无响应，请求排查原因

问题描述 #

测试用于捕获Twilio API对无效号码消息响应的代码时，发现以下异常：

• 测试错误固话号码+18135551212，完全收不到API响应，既无$message对象生成，也无法获取$message->sid用于Webhook或状态查询；
• 此前用户误输无效手机号时，API会返回带错误码的undelivered状态响应；
• 更换为有效手机号，代码运行一切正常。

使用的调用代码：

$client = new Client($authID,$authSecret);
$message = $client->messages->create(
    '+18135551212',
    array(
        'from' => $from,
        'body' => $msg
    )
);

原因分析 #

Twilio对不同类型无效号码的处理逻辑存在差异：

• 无效手机号：格式合法但无对应运营商资源，Twilio会先创建消息记录（生成sid），后续投递失败后返回undelivered状态并触发Webhook；
• 固话号码：默认不支持向固话发送SMS，Twilio会在请求阶段直接拦截请求，不会生成消息对象，若代码未做异常捕获，就会出现“无响应”的表现。

解决方案 #

1. 捕获API请求异常 #

添加异常处理逻辑，捕获Twilio拦截请求时抛出的错误，获取具体错误信息：

try {
    $client = new Client($authID,$authSecret);
    $message = $client->messages->create(
        '+18135551212',
        array(
            'from' => $from,
            'body' => $msg
        )
    );
    // 正常生成消息后的处理逻辑
} catch (\Twilio\Exceptions\RestException $e) {
    // 输出错误详情，便于排查
    echo "错误代码：{$e->getCode()}，错误信息：{$e->getMessage()}";
}

2. 提前校验号码类型 #

调用Twilio Lookup API提前判断号码类型，避免向固话发起无效SMS请求：

try {
    $lookup = $client->lookups->v1->phoneNumbers('+18135551212')->fetch(['type' => 'carrier']);
    if ($lookup->carrier['type'] === 'landline') {
        // 提示用户无法向固话发送短信，或触发短信转语音等替代逻辑
    } else {
        // 正常发起短信请求
        $message = $client->messages->create(/* 参数 */);
    }
} catch (\Twilio\Exceptions\RestException $e) {
    // 处理Lookup API调用错误
}

3. 开通固话短信支持 #

若业务需要向固话发送消息，可开通Twilio的SMS-to-Landline服务。开通后API会生成消息sid，通过语音播报短信内容，后续返回对应状态通知。

内容的提问来源于stack exchange，提问作者rolinger