Laravel移除集合元素后重新索引并修复分页异常，解决距离筛选查询作用域SQL语法错误

一、分页集合移除元素后分页显示异常的解决方案 #

你遇到的问题核心在于：paginate()返回的是LengthAwarePaginator对象，它的总条数、总页数等分页元数据是基于初始查询的全量数据计算的。手动用forget()移除集合元素，只会修改当前页的数据集，不会更新分页的核心统计信息，所以才会出现多数页面空白的情况。

这里有两个可行的解决思路：

1. 优先在数据库查询层面完成筛选（推荐） #

这是最优方案，把筛选逻辑放到数据库层面，既能减少数据传输量，分页统计也会自动基于筛选后的结果计算——也就是你尝试的查询作用域方案，修正语法后就能正常工作，下面会详细说明。

2. 若必须在集合层面处理，重新生成分页实例 #

如果确实需要在拿到集合后再做筛选（比如有些逻辑无法通过SQL实现），可以手动创建新的LengthAwarePaginator实例，基于筛选后的集合重新计算分页数据：

// 初始分页查询
$clinics = Clinic::orderBy('name', 'asc')->paginate(30)->withQueryString();

// 筛选距离符合条件的诊所
$filteredClinics = $clinics->filter(function ($clinic) use ($userLat, $userLong) {
    // 这里放入你的距离计算逻辑
    $distance = ...; // 计算当前诊所与用户地址的距离
    return $distance <= 20;
});

// 重新创建分页实例
$perPage = $clinics->perPage();
$currentPage = $clinics->currentPage();
$total = $filteredClinics->count();
$paginatedClinics = new \Illuminate\Pagination\LengthAwarePaginator(
    $filteredClinics->forPage($currentPage, $perPage),
    $total,
    $perPage,
    $currentPage,
    ['path' => \Illuminate\Pagination\Paginator::resolveCurrentPath()]
);

// 保留原查询字符串
$paginatedClinics->appends(request()->query());

这样新的分页实例就会基于筛选后的100条数据计算页数，不会再出现空白页面。

二、地理距离查询作用域的语法错误修复 #

你的SQL语法错误是因为long是MySQL的保留关键字，直接使用会导致解析错误，需要用反引号`把字段名包裹起来。修正后的作用域代码如下：

public function scopeCloseTo($query, $lat, $long) {
    // 用反引号包裹long和lat字段，避免关键字冲突
    return $query->whereRaw(" ST_Distance_Sphere( point(`long`, `lat`), point(?, ?) ) * 0.000621371192 < 20 ", [ $long, $lat ]);
}

补充说明： #

• ST_Distance_Sphere计算的单位是米，乘以0.000621371192是转换为英里；如果你的需求是20公里，应该乘以0.001，再判断< 20，这点要根据实际需求调整。
• 使用这个修正后的作用域后，分页查询会自动基于筛选后的结果计算总条数和页数，完全不需要手动处理集合：

// 调用作用域，直接得到正确分页的结果
$clinics = Clinic::orderBy('name', 'asc')
    ->closeTo($userLat, $userLong)
    ->paginate(30)
    ->withQueryString();

这样得到的$clinics就是已经筛选出20公里范围内的诊所，分页数据也完全准确，不会出现空白页面。

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