Laravel中whereHas关联查询调用paginate分页出现空白页问题

该问题基本由以下三类原因导致，可逐一排查：

• 调试仅对比了当前页的模型数据，未核对分页核心属性：使用whereHas做关联存在性查询时，如果关联定义存在全局作用域、多对多中间表约束配置错误，会导致分页统计总条数（total）、总页数逻辑异常。此时当前页数据和普通whereIn查询结果完全一致，但渲染分页链接时会因为非法页码、负数总条数等问题导致模板渲染失败，加上PHP错误提示被关闭，最终表现为页面空白。
• 分页链接生成与现有路由参数冲突：whereHas本身不会修改分页参数，但如果当前请求携带特殊字符、存在和分页保留参数page重名的路由参数，且没有显式配置分页允许携带的查询参数，会导致links()方法渲染分页HTML时触发过滤规则错误，返回空内容。
• 关联属性访问触发隐性错误：whereHas基于关联关系做筛选，如果视图遍历数据时直接访问themes关联属性但未做预加载，当关联数据存在未转义的特殊字符、和模板引擎指令重名的内容时，会导致模板编译失败；而普通whereIn查询如果刚好命中同一次请求中的模型关联缓存，就不会触发该问题。

按优先级逐一验证：

1. 先打印分页全量属性，确认核心参数一致
   临时在控制器中加调试代码，对比whereHas查询和正常的whereIn查询返回的分页核心参数是否完全相同：

   $quotes = Quote::whereHas('themes', function($q){
       // 注意规范写法为whereIn（大写I），PHP方法不区分大小写但部分版本存在兼容问题
       $q->whereIn('thema', ['txt1', 'txt2', 'txt3']);
   })->paginate(3);
   // 临时调试输出
   dd([
       'total' => $quotes->total(),
       'lastPage' => $quotes->lastPage(),
       'currentPage' => $quotes->currentPage(),
       'items' => $quotes->items()
   ]);
   

   如果total或lastPage值异常，优先检查themes关联定义：核对关联外键、本地键配置，多对多关联确认中间表名、关联键配置正确，临时移除关联模型上的全局作用域测试。
2. 显式配置分页查询字符串规则，排除参数冲突
   给分页调用withQueryString()方法保留合法查询参数，如果存在参数重名，自定义分页参数名：

   $quotes = Quote::whereHas('themes', function($q){
       $q->whereIn('thema', ['txt1', 'txt2', 'txt3']);
   })->paginate(3)
   ->withQueryString(); // 保留查询参数
   // 存在参数重名时用这个写法替换上面的paginate调用
   // ->paginate(3, ['*'], 'quote_page')
   

3. 添加关联预加载，排除视图层关联访问错误
   查询时加上with('themes')预加载关联数据，避免视图循环时触发N+1查询或关联数据读取异常：

   $quotes = Quote::whereHas('themes', function($q){
       $q->whereIn('thema', ['txt1', 'txt2', 'txt3']);
   })->with('themes')
   ->paginate(3)->withQueryString();
   

4. 排查分页视图渲染问题
   如果以上配置都正常，临时注释视图中的{{ $quotes->links() }}代码，只保留数据遍历逻辑。如果页面能正常显示数据，说明是分页视图本身的问题，可以执行php artisan vendor:publish --tag=laravel-pagination发布官方分页模板，排查自定义分页视图中的错误逻辑。

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