Laravel中DataTables服务端状态列无法按显示文本搜索问题

问题核心：服务端处理模式下，DataTables的搜索请求直接在数据库层面执行，而数据库status字段存的是1/2，并非前端显示的"Paid"/"Bal Dues"文本，所以搜索文本无法匹配到对应数据。

方案一：后端搜索映射（推荐，符合服务端处理逻辑） #

直接在后端判断搜索关键词，将"Paid"/"Dues"映射为对应的数据库status值，同时保留其他字段的正常搜索逻辑。

修改后端代码如下：

if ($request->ajax()) {
    $search = $request->input('search.value');
    
    $data = DB::table('invoices')
        ->leftJoin('invoice_items', 'invoice_items.invoice_id', '=', 'invoices.id')
        ->leftJoin('purchase', 'invoice_items.purchase_id', '=', 'purchase.id')
        ->select([
            'purchase.chassis', 'invoices.customer_name', 'invoices.invoice_date', 
            'invoices.total_price', 'invoices.total_paid', 'invoices.total_discount', 
            'invoices.balance_due', 'invoices.status', 'invoices.id as invoice_id'
        ]);

    // 处理全局搜索逻辑
    if (!empty($search)) {
        $statusCondition = null;
        // 匹配状态关键词，忽略大小写
        if (stripos($search, 'paid') !== false) {
            $statusCondition = DB::raw('invoices.status = 1');
        } elseif (stripos($search, 'dues') !== false) {
            $statusCondition = DB::raw('invoices.status = 2');
        }
        
        $data->where(function($query) use ($search, $statusCondition) {
            // 先处理状态匹配
            if ($statusCondition) {
                $query->orWhere($statusCondition);
            }
            // 其他字段的模糊搜索
            $query->orWhere('purchase.chassis', 'like', "%{$search}%")
                  ->orWhere('invoices.customer_name', 'like', "%{$search}%")
                  ->orWhere('invoices.invoice_date', 'like', "%{$search}%")
                  ->orWhere('invoices.total_price', 'like', "%{$search}%")
                  ->orWhere('invoices.total_paid', 'like', "%{$search}%")
                  ->orWhere('invoices.total_discount', 'like', "%{$search}%")
                  ->orWhere('invoices.balance_due', 'like', "%{$search}%");
        });
    }

    return Datatables::of($data)
        ->addIndexColumn()
        ->addColumn('invoice_no', function($row){
            return "SI-" . $row->invoice_id;
        })
        ->addColumn('status', function($row){
            if ($row->status == 1)
                $status = "<label class='badge badge-success'>Paid</label>";
            else
                $status = "<label class='badge badge-danger'>Bal Dues</label>";
            return $status;
        })
        ->addColumn('action', function ($row) {
            $itemsCount = InvoiceItem::where('invoice_id', $row->invoice_id)->count();
            $btn = '<a href="' . route('invoices.edit', $row->invoice_id) . '"><i class="fe fe-printer me-2"></i></a>';
            $btn .= '<a href="' . route('invoices.edit', $row->invoice_id) . '"><i class="fe fe-eye"></i> View ('. $itemsCount .')</a>';
            return $btn;
        })
        ->rawColumns(['invoice_no', 'action', 'status'])
        ->make(true);
}

return view("invoices.index");

方案二：新增状态文本字段（适合简单场景） #

在后端给每条数据添加status_text字段，让DataTables基于该文本字段搜索，前端仍显示格式化后的标签。

1. 后端添加status_text字段：

return Datatables::of($data)
    ->addIndexColumn()
    ->addColumn('invoice_no', function($row){
        return "SI-" . $row->invoice_id;
    })
    // 新增状态文本字段
    ->addColumn('status_text', function($row){
        return $row->status == 1 ? "Paid" : "Bal Dues";
    })
    ->addColumn('status', function($row){
        if ($row->status == 1)
            $status = "<label class='badge badge-success'>Paid</label>";
        else
            $status = "<label class='badge badge-danger'>Bal Dues</label>";
        return $status;
    })
    ->addColumn('action', function ($row) {
        $itemsCount = InvoiceItem::where('invoice_id', $row->invoice_id)->count();
        $btn = '<a href="' . route('invoices.edit', $row->invoice_id) . '"><i class="fe fe-printer me-2"></i></a>';
        $btn .= '<a href="' . route('invoices.edit', $row->invoice_id) . '"><i class="fe fe-eye"></i> View ('. $itemsCount .')</a>';
        return $btn;
    })
    ->rawColumns(['invoice_no', 'action', 'status'])
    ->make(true);

2. 前端修改列配置，将status列的搜索关联到status_text：

columns: [
    // ...其他列配置
    {data: 'status', name: 'status_text'}, // 用status_text字段做搜索匹配
    {data: 'action', name: 'action', orderable: false, searchable: false},
],

注意事项 #

确认数据库status字段的实际存储值：部分数据库（如SQL Server）的bit类型默认取值为0/1，若你的实际存储是1/2，需确保判断条件与数据库值一致。

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