在 Laravel 中使用 Eloquent 执行带行号（counter）的查询时，不能在 SELECT 子句中直接用 SET @counter = 0 初始化变量；需先通过 DB::statement() 单独执行变量初始化，并将保留字 index 用双引号转义，才能正确生成自增序号。
在 laravel 中使用 eloquent 执行带行号（counter）的查询时，不能在 `select` 子句中直接用 `set @counter = 0` 初始化变量；需先通过 `db::statement()` 单独执行变量初始化，并将保留字 `index` 用双引号转义，才能正确生成自增序号。
Laravel 的 Eloquent 查询构建器底层调用的是 PDO，而 MySQL/MariaDB 不允许在单条 SELECT 语句中混合执行 SET 变量声明与查询逻辑——这正是你遇到 SQLSTATE[42000]: Syntax error... near 'SET @counter = 0' 错误的根本原因。
✅ 正确做法是分两步处理：
-
先执行变量初始化语句（使用
DB::statement()）； -
再执行带变量计算的查询，并在列别名中对 SQL 保留字（如
index）进行转义。
以下是推荐的完整实现：
use Illuminate\Support\Facades\DB;
use App\Models\JobOrder;
// 第一步：显式初始化用户变量（注意：仅对当前数据库连接有效）
DB::statement('SET @counter = 0');
// 第二步：执行查询，使用变量生成行号
$jobOrders = JobOrder::select([
DB::raw('(@counter := @counter + 1) as "index"'),
'job_order_id',
'job_order_code',
'job_title',
'job_overview',
'posting_date',
'visibility_order'
])
->orderBy('visibility_order') // 建议明确排序，确保行号顺序可预期
->get();⚠️ 注意事项：
-
@counter是会话级用户变量，仅对当前数据库连接生效，多请求并发下无需担心冲突，但也不建议跨查询复用； -
index是 MySQL 的保留关键字，若不加引号（如"index"或`index`），会导致语法错误或意外行为； - 此方案依赖 MySQL/MariaDB，不具备数据库无关性；如需兼容 PostgreSQL 或 SQLite，应改用窗口函数（如
ROW_NUMBER() OVER ()）并配合DB::raw()实现； - 若数据量较大且需分页，不推荐此方式——行号需基于完整结果集计算，
LIMIT/OFFSET会破坏序号连续性；此时更合理的方式是在应用层添加索引（如$collection->mapWithKeys(...)）或使用数据库原生分页+窗口函数。
? 进阶建议：Laravel 9+ 支持原生窗口函数语法（需数据库支持），更健壮的替代写法如下（MySQL 8.0+/PostgreSQL）：
JobOrder::selectRaw('ROW_NUMBER() OVER (ORDER BY visibility_order) as "index"')
->select(['job_order_id', 'job_order_code', 'job_title', /* ... */])
->orderBy('visibility_order')
->get();该方式无需手动管理变量，语义清晰、线程安全，且天然支持分页与排序组合，是现代 Laravel 应用中更推荐的实践。
