必须手动控制连接选择与结果聚合:配置db_shard_0/db_shard_1多库组件并显式设charset为utf8mb4;order模型中getdb()按user_id取模路由,无分片键时返回null;跨分片时间分页推荐游标分页,避免全局归并内存溢出。

当Yii应用的订单表已按用户ID哈希分片到db_shard1和db_shard2两个数据库,且需支持后台管理员按时间范围跨分片查询全部订单并分页时,必须绕过ActiveRecord默认单库路由,手动控制连接选择与结果聚合。
配置多数据库连接组件
在config/web.php的components数组中,定义至少两个独立DB组件,命名需体现分片语义,如db_shard_0和db_shard_1;不能复用db主连接,否则路由逻辑将失效。
每个组件必须显式指定charset为utf8mb4,否则中文字段可能出现乱码;tablePrefix可统一设为空字符串,避免分片表名被意外拼接前缀。
连接参数中的host必须指向真实分片数据库IP,不可使用localhost——本地回环会强制走同一台物理机,彻底失去分库意义。
重写模型的getDb()实现动态路由
在订单模型Order.php中,覆盖父类getDb()方法,根据当前查询条件返回对应DB组件实例。
若查询含user_id条件,直接按$user_id % 2取模,返回Yii::$app->get('db_shard_' . ($user_id % 2));这是最轻量的单分片路由,性能无损。
若查询不含分片键(如后台查所有订单),则必须返回null,强制后续查询抛出异常——【禁止在此处返回任意一个固定分片连接】,否则将漏查数据,且错误静默难以定位。
跨分片时间分页查询的两种落地方式
方法一:应用层全局归并(适合页码≤50)
第一步:构造分片独立SQL,对每个分片执行SELECT * FROM order_2026 WHERE created_at BETWEEN ? AND ? ORDER BY created_at DESC LIMIT 0,100(取前100条,因需合并后截取第2页10条)。
第二步:用PHP的array_merge()合并所有分片结果集,再用usort()按created_at全局降序重排。
第三步:用array_slice($merged, 10, 10)截取第2页数据。注意:内存中排序会消耗显著CPU,单次请求数据量超5万行易触发PHP内存限制。
方法二:基于最大时间戳的游标分页(推荐用于生产)
首次查询第1页:执行SELECT * FROM order_2026 ORDER BY created_at DESC LIMIT 10,记录返回结果中最小的created_at值(即最后一条的时间戳)。
后续翻页:将上一页最后的时间戳作为游标,执行SELECT * FROM order_2026 WHERE created_at ;该SQL需在每个分片上并行执行,结果合并后无需二次排序,直接取满10条即止。
这一步必须确保created_at字段有B-tree索引,否则WHERE条件将触发全表扫描,性能比传统offset分页更差。











