Laravel ORM查询字符串字段遇类型转换致索引失效问题求助

问题核心是Laravel查询构建器会自动对字符串类型的查询值做隐式类型转换，导致生成的SQL中用整数和varchar字段比较，触发数据库的隐式类型转换，进而使索引失效。以下是几种可行的解决办法：

1. 正确使用whereRaw参数绑定 #

避免手动给绑定参数加引号，让PDO自动处理字符串类型：

$orderId = 319769;
$shipOrder = ShipOrderModel::whereRaw('order_id = ?', [(string)$orderId])->first();

生成的SQL会是：select * from hr_ship_order where order_id = '319769'，确保数据库以字符串类型进行比较，正常走索引。

2. 结合DB::raw强制字符串比较 #

如果需要直接构造字符串条件，确保传入带单引号的字符串（注意要保证参数安全，避免SQL注入）：

$orderId = (string)319769;
$shipOrder = ShipOrderModel::where('order_id', DB::raw("'{$orderId}'"))->first();

这种方式会直接在SQL中生成带单引号的字符串值，强制字段以字符串规则匹配。

3. 封装查询范围（Scope）复用逻辑 #

在ShipOrderModel中定义自定义查询范围，统一处理order_id的字符串查询：

class ShipOrderModel extends Model
{
    public function scopeWhereOrderId($query, $orderId)
    {
        return $query->whereRaw('order_id = ?', [(string)$orderId]);
    }
}

使用时只需调用封装好的方法：

$shipOrder = ShipOrderModel::whereOrderId(319769)->first();

为什么之前的写法无效？ #

• 直接where('order_id', '319769')：Laravel会根据字段的数据库类型或模型$casts配置自动转换值类型，最终还是生成整数条件。
• 错误的whereRaw写法：whereRaw('order_id = "?"', $orderId)会把参数绑定在双引号内，生成的SQL是order_id = "319769"，部分数据库对双引号字符串的处理和单引号不同，且不符合参数绑定的规范。

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