Laravel集成Yajra Datatables时搜索触发SQL列不存在错误的解决求助

这个错误的根源很明确：你的Datatables配置里最后一列设置了{ data: '' }，当开启服务端处理时，Yajra Datatables会尝试对所有配置的列生成搜索条件，这个空的data值会让SQL语句里出现customer.（空列名），从而触发Column not found错误。

下面是具体的修复步骤：

1. 优化控制器查询（可选但推荐） #

先确保你的查询只选择需要的字段，避免冗余，同时保持排序逻辑：

$query = DB::table('customer')
    ->select('id', 'fullname', 'num_doc', 'mobile', 'email', 'class')
    ->orderBy('id');
return DataTables::queryBuilder($query)->toJson();

2. 修正前端Datatables配置 #

把那个空数据的列改成符合需求的格式，如果是用来放置操作按钮（编辑、删除等），需要明确设置它不可搜索、不可排序，避免服务端对它生成无效的SQL：

if (dtUserTable.length) {
    dtUserTable.DataTable({
        pageLength: 10,
        stateSave: true,
        processing: true,
        serverSide: true,
        ajax:{url:"customer-list"},
        columns: [
            { data: 'id' },
            { data: 'fullname' },
            { data: 'num_doc'},
            { data: 'mobile' },
            { data: 'email' },
            { data: 'class' },
            { 
                data: null, // 操作列不需要绑定具体数据字段，用null即可
                orderable: false,
                searchable: false,
                render: function(data, type, row) {
                    // 这里替换成你的操作按钮HTML代码
                    return `
                        <button class="btn btn-sm btn-primary" data-id="${row.id}">编辑</button>
                        <button class="btn btn-sm btn-danger" data-id="${row.id}">删除</button>
                    `;
                }
            }
        ],
        columnDefs: [
            { 
                className: 'control',
                orderable: false,
                responsivePriority: 2,
                targets: 0
            }
        ]
    });
}

为什么之前会出现“单独工作正常”的情况？ #

• 当你关闭服务端处理（直接返回get()的结果），Datatables在前端处理搜索，会自动忽略空数据的列，所以不会报错，但失去了服务端处理的性能优势。
• 如果你之前调整配置时不小心去掉了空列，搜索就能正常工作，但可能丢失了操作列的功能。

修改完成后，你应该能同时正常使用服务端分页、排序和全局搜索功能了。

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