线上用户表超300万、订单表日增8万致响应慢，需零停机分表迁移：先验mysql版本与主键类型，禁用uuid作分表键；建4张哈希分表并改造主键；模型层用gettable()、settable()或trait实现路由；事务须同表、关联查用手动sql、分页改游标。
线上用户表突破三百万后查询响应超1.2秒，订单表日增八万条导致慢查询告警频发，必须在不中断服务的前提下完成分表迁移与路由切换。
确认分表可行性与风险点
先检查当前数据库版本是否支持在线 DDL：执行 SELECT VERSION()，MySQL 5.6+ 才能用 ALGORITHM=INPLACE 避免锁表；低于该版本必须停机维护。
确认主键类型：分表键（shard key）必须是整型或可转为整型的字符串，【禁止用 UUID 或无序字符串作分表键】，否则哈希后数据倾斜严重，某张分表可能占全量数据70%以上。
检查所有 JOIN 查询：grep -r "join.*on" app/，若发现跨分表键关联（如 orders.user_id JOIN users.id），必须提前改造成应用层双查——这步不做，上线后 90% 的列表页会直接报错。
按用户ID哈希生成4张物理表
运行四条迁移命令一次性创建分表结构：
php artisan make:migration create_users_0_table --create=users_0 → php artisan make:migration create_users_1_table --create=users_1 → php artisan make:migration create_users_2_table --create=users_2 → php artisan make:migration create_users_3_table --create=users_3
每个迁移文件中复制原始 users 表结构，但删掉 $table->id()，改用 $table->unsignedBigInteger('id')->primary() —— 因为 Laravel 默认 id 是自增 bigint，而分表后主键需由业务层生成或用雪花算法，不能依赖 MySQL 自增。
执行迁移：php artisan migrate --force。注意：生产环境加 --force 参数才允许执行，否则提示“未在交互终端确认”。
模型层动态路由实现
方法一：重写 getTable()（推荐用于读多写少场景）
在 App\Models\User.php 中定义：
public function getTable(){ $userId = $this->getAttribute('id') ?: request()->input('user_id'); return 'users_' . ($userId % 4);}
这方法简单，但有个致命坑：当调用 User::where('name', '张三')->first() 时，$this 没实例化，getAttribute('id') 返回 null，结果永远查 users_0 表——所以必须配合 where 条件里显式传 user_id。
方法二：使用 setTable() 实例化后绑定（强推用于写操作）
控制器中这样写：
$user = (new User)->setTable('users_' . ($id % 4))->find($id);
关键点在于：find() 必须紧跟 setTable() 后调用，中间不能穿插其他链式方法，否则 setTable() 生效范围丢失。Eloquent 的 query builder 在第一次执行前才真正解析表名。
方法三：Trait 封装 + 请求上下文注入（适合 SaaS 多租户）
新建 app/Traits/Shardable.php：
trait Shardable{ protected static function bootShardable() { static::addGlobalScope('shard', function (Builder $builder) { $tenantId = request()->header('X-Tenant-ID') ?: session('tenant_id'); $builder->from('users_' . (crc32($tenantId) % 4)); }); }}
然后在 User 模型中 use Shardable；此方式对现有代码侵入最小，但全局作用域无法用于 insert/update，仅适用于 select。
分表后事务与关联查询处理
第一步：事务内所有操作必须命中同一张物理表
错误写法：DB::transaction(function () { User::find(101)->update([...]); Order::find(201)->update([...]); }); —— User 和 Order 分表逻辑不同，事务跨了两张物理表，MySQL 直接拒绝提交。
正确做法：先算出 user_id 对应的分表编号，再把两个模型都绑定到同一编号表：
$shardId = 101 % 4;DB::transaction(function () use ($shardId) { (new User)->setTable("users_{$shardId}")->where('id', 101)->update([...]); (new Order)->setTable("orders_{$shardId}")->where('user_id', 101)->update([...]);});
第二步：关联查询禁用 Eloquent 默认 with()
在 User 模型中注释掉 public function orders() 方法，改用手动构造：
public function getOrdersAttribute(){ $shardId = $this->id % 4; return DB::table("orders_{$shardId}")->where('user_id', $this->id)->get();}
第三步：分页必须弃用 offset/limit
把 User::paginate(20) 全部替换成游标分页：
$lastId = request()->input('cursor', 0);$users = User::where('id', '>', $lastId)->orderBy('id')->take(20)->get();return response()->json(['data' => $users, 'next_cursor' => $users->last()?->id]);
