Twilio双向短信平台存储媒体触发SQL非空约束错误排查

你遇到的SQLSTATE[23000]: Integrity constraint violation: 1048 Column 'receiver' cannot be null错误，核心原因是插入SMSHistory记录时receiver字段（对应代码里的$to变量）为空，同时代码里还有几处逻辑错误触发了这个问题，我帮你逐一排查修复：

1. 条件判断里的致命赋值错误 #

在replyTwilio方法的请求校验逻辑中，有两个明显问题：

if ($number == '' && $body = '' && $to == '') {
    return 'Invalid Request';
}

• $body = ''是赋值操作，不是相等判断，应该写成$body == ''；
• 逻辑运算符用了&&（逻辑与），意味着只有当$number、$body、$to三者全为空时才拒绝请求，但Twilio发送纯媒体短信时Body字段是空的，这会导致该判断不触发，代码继续执行；如果此时$to字段获取失败（比如Twilio请求中To缺失），就会导致插入时receiver为空。

如果你的平台需要支持纯媒体短信（无文字内容），可以把校验逻辑改成这样：

// 只要手机号、接收号为空，或者既无文字也无媒体，就拒绝请求
if ($number == '' || $to == '' || ($numMedia == 0 && $body == '')) {
    return 'Invalid Request';
}

2. 媒体URL获取的语法错误 #

PHP中字符串拼接必须用.，而不是+，你当前的代码：

$mediaUrl = $request->input('MediaUrl' + $i) + ',';

会把'MediaUrl'当作数字0处理，最终变成$request->input($i)，根本无法获取到正确的MediaUrl0、MediaUrl1等字段；同时循环条件$i <= $numMedia也有误——Twilio的NumMedia是媒体数量，MediaUrl的索引从0到NumMedia-1，比如NumMedia=2时，只有MediaUrl0和MediaUrl1，没有MediaUrl2。

修复后的媒体URL处理代码：

$mediaUrl = '';
if ($numMedia != 0) {
    for ($i = 0; $i < $numMedia; $i++) {
        $currentMediaUrl = $request->input('MediaUrl' . $i);
        if ($currentMediaUrl) {
            $mediaUrl .= $currentMediaUrl . ',';
        }
    }
    // 移除末尾多余的逗号
    $mediaUrl = rtrim($mediaUrl, ',');
}

3. 额外的健壮性优化 #

为了彻底避免$to为空的情况，你可以在insertSMS方法开头添加一次非空校验：

public function insertSMS($number, $msg_count, $body, $to = '', $gateway = '', $media, $num_media) {
    // 新增：如果接收号为空，直接返回失败
    if (empty($to)) {
        return false;
    }
    
    // 原方法剩余代码...
}

修复后的完整replyTwilio方法示例 #

public function replyTwilio(Request $request) {
    $number = $request->input('From');
    $to = $request->input('To');
    $body = $request->input('Body');
    $numMedia = $request->input('NumMedia');
    $mediaUrl = '';

    // 支持纯媒体短信的请求校验
    if ($number == '' || $to == '' || ($numMedia == 0 && $body == '')) {
        return 'Invalid Request';
    }

    if ($numMedia != 0) {
        for ($i = 0; $i < $numMedia; $i++) {
            $currentMediaUrl = $request->input('MediaUrl' . $i);
            if ($currentMediaUrl) {
                $mediaUrl .= $currentMediaUrl . ',';
            }
        }
        $mediaUrl = rtrim($mediaUrl, ',');
    }

    $clphone = str_replace([" ", "+"], "", $number);
    $msgcount = ceil(strlen($body) / 160);
    $get_status = $this->insertSMS($clphone, $msgcount, $body, $to, 1, $mediaUrl, $numMedia);

    return $get_status ? 'success' : 'failed';
}

这些修改应该能解决你遇到的receiver为空的错误，同时修复媒体URL获取的问题。

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