字段用 integer 类型、default(0)、加 INDEX 索引；批量更新用 DB::statement 拼 CASE SQL；scope 必须 return orderBy 并显式调用；Redis 缓存用 Lua 原子更新带版本号键。
模型排序字段怎么设才不踩坑
直接用 order 或 sort_order 作为字段名没问题，但必须加索引，否则拖拽频繁更新时会锁表、慢得明显。别用 tinyint 存顺序值——超出 255 就得重排，推荐 integer 或 unsignedInteger。
常见错误现象：Integrity constraint violation: 1062 Duplicate entry '1' for key 'users.order'，说明没设唯一索引或并发更新没处理；还有人用 float 类型想插中间值（比如 1.5），结果浮点精度导致后续无法插入。
- 字段类型选
integer，默认值设0，加INDEX（非唯一）即可，唯一性由业务逻辑保证 - 迁移里写：
Schema::table('menus', function (Blueprint $table) { $table->integer('sort_order')->default(0)->index(); }); - 不要在模型里用
$casts = ['sort_order' => 'int']，整型字段原生支持，加了反而可能干扰批量赋值
拖拽后怎么原子化更新多条记录
Laravel 自带的 updateOrCreate 或逐条 save() 都不行——网络延迟 + 多次查询会让顺序错乱，尤其多人同时操作菜单或任务列表时。
正确做法是：前端传回一个 ID → 排序值的映射数组，后端用单条 DB::statement() 批量更新，绕过 Eloquent 生命周期，避免 N+1 和事务卡顿。
- 前端传参示例：
{"12":1,"45":2,"33":3} - 后端解析后拼 SQL：
DB::statement("UPDATE posts SET sort_order = CASE id WHEN ? THEN ? WHEN ? THEN ? END WHERE id IN (?, ?)", [12, 1, 45, 2, 12, 45]); - 注意：参数必须严格按顺序配对，
CASE WHEN的每个分支都要有对应占位符，否则 PDO 绑定报错SQLSTATE[HY093]: Invalid parameter number
怎么让 scopeOrderBySortOrder 真正生效
很多人写了 scopeOrderBySortOrder()，调用时却还是按主键排——因为没在查询末尾显式调用 ->orderBy('sort_order')，Eloquent 的 scope 不会自动“覆盖”其他 order 条件。
更隐蔽的问题是：如果模型用了软删除，orderBy('sort_order') 在 withTrashed() 下仍有效，但在 onlyTrashed() 时可能因数据缺失导致空值排最前，视觉上像“失效”。
- scope 写法必须返回
$builder->orderBy('sort_order')，不能只写orderBy不 return - 调用时要明确链式写：
Post::orderBySortOrder()->get()，而不是Post::get()->sortBy('sort_order')（后者是 Collection 排序，已查库） - 如果需要升序/降序可选，加参数：
scopeOrderBySortOrder($builder, $direction = 'asc')，然后传->orderBy('sort_order', $direction)
Redis 缓存排序结果时怎么同步更新
缓存 posts:sorted_ids 这种列表很常见，但拖拽一更新，缓存和 DB 就不同步——不是删缓存就完事，因为删了下次查又得全量重排，压力大。
真正轻量的做法是：只缓存「当前页」的排序 ID 列表，并在更新时用 Lua 脚本原子化修改 Redis 中对应位置的 ID，而不是全量刷新。
- 缓存键建议带版本号：
posts:sorted_ids:v2，字段变更或逻辑调整时直接切版本，避免脏数据残留 - 更新时用
Redis::eval()执行 Lua，把新顺序数组写入 list，再EXPIRE，两步必须在一个 eval 里完成 - 别用
Cache::forget()后再查 DB 写缓存——高并发下多个请求会同时重建缓存，造成雪崩
