Laravel EloquentDataTable查询始终最多返回10条数据问题排查

我尝试在视图中根据订单ID展示ProductOrder列表，但遇到了一个奇怪的问题：当查询order_id=314的订单时，数据库中明明存在11条相关记录，原生SQL查询能正常返回全部11条，但通过EloquentDataTable获取数据时，始终最多只返回10条。以下是相关代码和依赖信息，希望能得到排查方向或解决方案。

相关代码片段 #

app/Datatables/ProductOrderDatatables.php 中的 dataTable 方法 #

public function dataTable($query) { 
    $dataTable = new EloquentDataTable($query); 
    $columns = array_column($this->getColumns(), 'data'); 
    $dataTable = $dataTable 
        ->editColumn('price', function ($productOrder) { 
            return getPriceColumn($productOrder); 
        }) 
        ->rawColumns(array_merge($columns)); 
    return $dataTable; 
}

同文件中的 query 方法 #

public function query(ProductOrder $model) { 
    return $model->newQuery()->with("product") 
        ->where('product_orders.order_id', $this->id) 
        ->select('product_orders.*')->orderBy('product_orders.id', 'desc'); 
}

依赖包信息 #

namespace App\DataTables; 
use App\Models\CustomField; 
use App\Models\ProductOrder; 
use App\Models\Product; 
use Barryvdh\DomPDF\Facade as PDF; 
use Yajra\DataTables\EloquentDataTable; 
use Yajra\DataTables\Services\DataTable; 
use Illuminate\Support\Facades\Log; 
use DB;

排查与解决方案建议 #

结合你的情况，最可能的原因是DataTables默认的分页设置，下面是具体的排查步骤和解决办法：

• 检查并调整后端分页配置
  Yajra DataTables默认启用分页，每页默认显示10条数据。如果你需要返回全部记录，可以在dataTable方法中强制关闭分页：

public function dataTable($query) { 
    $dataTable = new EloquentDataTable($query); 
    $columns = array_column($this->getColumns(), 'data'); 
    $dataTable = $dataTable 
        ->editColumn('price', function ($productOrder) { 
            return getPriceColumn($productOrder); 
        })
        ->setPaging(false) // 关闭分页，返回所有匹配的记录
        ->rawColumns(array_merge($columns)); 
    return $dataTable; 
}

如果只是想调整每页显示的数量，可以用->setPageLength(20)（设置每页20条）或者->setLengthMenu([10,25,50,100])提供可选的分页大小。

• 验证查询构建器的原始结果
  先确认你的查询本身是否能获取到11条记录，在query方法中临时添加日志输出：

public function query(ProductOrder $model) { 
    $query = $model->newQuery()->with("product") 
        ->where('product_orders.order_id', $this->id) 
        ->select('product_orders.*')->orderBy('product_orders.id', 'desc');
    
    // 记录查询到的总条数
    Log::info('ProductOrder查询记录数：' . $query->count());
    
    return $query; 
}

查看日志，如果显示的是11，说明问题出在EloquentDataTable的处理环节；如果是10，那就要检查查询条件是否有隐藏的过滤（比如模型的软删除、全局作用域等）。

• 检查前端DataTables配置
  如果是前端启用了服务端分页，可能前端设置了pageLength:10，可以调整前端的初始化代码：

$('#your-table-id').DataTable({
    pageLength: -1, // 显示全部数据
    // 其他配置...
});

或者如果需要保留分页，把pageLength设为足够大的数值，比如20。

• 排查全局作用域或模型过滤
  检查ProductOrder模型是否有全局作用域（比如限制状态、软删除等），可以暂时禁用全局作用域测试：

public function query(ProductOrder $model) { 
    return $model->newQuery()
        ->withoutGlobalScopes() // 禁用所有全局作用域
        ->with("product") 
        ->where('product_orders.order_id', $this->id) 
        ->select('product_orders.*')->orderBy('product_orders.id', 'desc'); 
}

如果这样能返回11条，说明是某个全局作用域过滤掉了一条记录，需要调整作用域逻辑。

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