Laravel 8.54.0+Livewire加载下拉数据时SQLSTATE参数绑定超2100上限错误如何解决

问题根因 #

你遇到的SQLSTATE[IMSSP]报错是因为SQL Server单次执行SQL最多支持2100个参数绑定，当查询语句绑定的参数数量超过该阈值就会触发此报错。
额外确认：你的Item模型中配置的连接是mysql2，但报错是SQL Server的专有错误，先确认config/database.php中mysql2连接的驱动配置是否符合你的实际使用需求，若实际使用的是MySQL需修正驱动为mysql。

解决方案 #

• 方案1（推荐）：优化下拉交互，避免全表拉取
  上千条数据的下拉框用户体验极差，改用异步搜索加载，每次仅拉取匹配的少量数据，从根源避免参数超限问题：

  // Livewire 控制器代码
  public $produk_search = '';
  public $produk_code = '';
  
  public function render()
  {
      return view('你的视图路径', [
          'produk_ictn_row' => Item::where('Kode', 'like', "%{$this->produk_search}%")->take(50)->get()
      ]);
  }
  

  视图层新增搜索输入框绑定wire:model.lazy="produk_search"即可。

• 方案2：全量数据拆分查询
  若业务确实需要拉取全表数据，使用chunk方法拆分查询，单次查询数据量不超过2000条：

  // Livewire 控制器代码
  $produkList = [];
  Item::chunk(2000, function ($items) use (&$produkList) {
      foreach ($items as $item) {
          $produkList[] = $item;
      }
  });
  $this->produk_ictn_row = collect($produkList);
  

• 方案3：原生SQL查询规避参数绑定
  若仅需要下拉用到的Kode字段，直接执行无绑定参数的原生SQL：

  $this->produk_ictn_row = DB::connection('mysql2')->select('SELECT Kode FROM item');
  

• 额外修复点：视图层循环变量重名问题
  你当前的视图循环代码集合与单条变量重名，会导致逻辑异常，修改为：

  <select disabled name="formkodeproduk" id="formkodeproduk" class="form-control @error('formkodeproduk') is-invalid @enderror" wire:model="produk_code">
  @foreach($produk_ictn_row as $produk)
      <option value="{{$produk->Kode}}">{{$produk->Kode}}</option>
  @endforeach
  </select>
  

排查建议 #

如果上述方案仍未解决问题，检查Item模型是否存在全局查询作用域（Global Scope），若作用域中存在whereIn传入大量参数的逻辑，将参数数组拆分为多个不超过2000个元素的数组分批查询即可。

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