Laravel原生查询参数绑定问题：SELECT段绑定失效报HY093错误

我之前也碰到过一模一样的问题！Laravel里用DB::raw在select里绑定参数的时候，确实会出现这种参数不匹配的错误，而whereRaw却能正常工作，下面给你说下原因和解决办法：

问题根源 #

Laravel的查询构建器对whereRaw的参数绑定处理是自动的——它会把你传入的绑定参数自动加入到查询的全局绑定数组里。但select(DB::raw())不一样：DB::raw对象里的占位符不会被查询构建器自动识别并收集绑定参数，导致最终生成的SQL里的占位符数量，和实际绑定的参数数量不匹配，就抛出了SQLSTATE[HY093]: Invalid parameter number这个错误。

最优解决方案：用selectRaw替代select(DB::raw()) #

Laravel专门提供了selectRaw方法，它和whereRaw一样支持直接传入绑定参数，能完美解决这个问题。举个例子：

// 假设你要拼接description字段，同时按时间过滤
$descriptionSuffix = " - 已审核";
$filterDate = "2024-01-01";

$aJob = Job::selectRaw('id, title, CONCAT(description, ?) as full_description', [$descriptionSuffix])
           ->whereRaw('created_at >= ?', [$filterDate])
           ->paginate(10);

这样selectRaw里的占位符?会自动和你传入的[$descriptionSuffix]绑定，同时whereRaw的参数也会正常处理，不会出现参数数量不匹配的问题。

备选方案：手动管理绑定参数（不推荐，除非特殊场景） #

如果你一定要用DB::raw在select里，可以手动把所有绑定参数合并，然后通过setBindings方法设置给查询构建器。注意参数顺序必须和SQL里的占位符完全对应：

$bindings = [$descriptionSuffix, $filterDate]; // 顺序要和SQL里的?一一对应

$aJob = Job::select(DB::raw('id, title, CONCAT(description, ?) as full_description'))
           ->whereRaw('created_at >= ?')
           ->setBindings($bindings)
           ->paginate(10);

这种方法容易出错，比如后续修改SQL占位符顺序但忘了调整绑定数组，所以优先用selectRaw。

调试技巧验证 #

你提到的print_r($aJob->toSql())和print_r($aJob->getBindings())是非常好用的调试手段：

• 运行toSql()可以看到生成的SQL里有几个?占位符
• 运行getBindings()可以看到实际被绑定的参数数量
  如果两者数量不一致，就说明是我们前面说的问题，用上面的方法修复后，两者数量就会匹配了。

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