分表逻辑必须由模型层主动控制，需重写getTableName()或动态设table，禁用硬拼表名、严格校验后缀、统一用DATETIME索引、PHP合并聚合查询。
分表逻辑必须由模型层主动控制，不能依赖数据库中间件
ThinkPHP 本身不提供自动分片路由，Db 或 Model 不会根据主键或时间自动切到 user_202401 这类表。你得在查询前就决定用哪张物理表——否则查的永远是配置里写的默认表名。
常见错误现象：Undefined table: 1146 Table 'db.user' doesn't exist，其实是代码还在查基础表名，但实际数据已按月拆到 user_202401、user_202402 里。
- 所有涉及分表的模型，需重写
getTableName()方法，或在initialize()中动态设置$this->table - 避免在
where条件里用table('user_'.date('Ym'))硬拼——这会导致 ORM 失去关联、预处理失效 - 如果用
scope封装分表逻辑，注意 scope 不影响getTableName()，仍需提前切换表名
按时间分表时，create_time 字段必须索引且类型为 DATETIME 或 TIMESTAMP
按月分表最常用，但容易忽略字段类型和索引问题：若 create_time 是 VARCHAR 存 "2024-01-01"，MySQL 无法高效 range 分区，WHERE create_time >= '2024-01-01' 可能全表扫描。
使用场景：用户注册日志、订单记录等有强时间维度的数据。
立即学习“PHP免费学习笔记（深入）”；
- 建表时统一用
DATETIME，别用字符串模拟时间 - 每个分表都必须单独为
create_time建索引，ThinkPHP 不会帮你跨表建 - 分表命名建议用
log_202401而非log_2024_01，避免下划线干扰解析逻辑
Db::name() 动态调用要防 SQL 注入，别直接拼接用户输入
有人写 Db::name('order_'.$_GET['month'])->select()，这是高危操作。攻击者传 month=202401; DROP TABLE order_202401 虽然不会执行（PDO 预处理限制），但可能触发异常或绕过校验。
参数差异：Db::name() 接收字符串，不做任何过滤；而 where() 中的值会被参数化，但表名永远不会。
- 严格校验分表后缀：只允许
^\d{6}$（如 202401），拒绝任何字母、符号、超长数字 - 把合法分表名缓存在数组或 Redis 中，运行时只做白名单匹配
- 不要用
__TABLE__占位符 +str_replace，那等于自己造注入点
跨分表聚合查询只能靠 PHP 合并，别指望 UNION ALL 自动优化
想查“最近三个月总订单数”，不能写 SELECT COUNT(*) FROM (SELECT * FROM order_202401 UNION ALL SELECT * FROM order_202402 ...) —— ThinkPHP 的 union() 不支持跨库/跨物理表的复杂嵌套，而且 MySQL 对 UNION 的索引利用极差。
性能影响：单表查 10ms，三张表并发查再 PHP 合计，通常比一条 UNION 快 2–5 倍，还容易加缓存。
- 用
Swoole\Coroutine\Channel或pcntl_fork并发查多张表（仅限 CLI 场景） - Web 请求中老实用 for 循环 +
Db::name($table)->count()，配合cache()缓存结果 - 避免在分表场景下用
withCount()关联统计，它会为每条主记录发起一次分表查询
分片不是加个配置就能跑起来的事，表名怎么生成、时间字段怎么查、用户输入怎么拦、聚合怎么算——每个环节漏一环，线上就查慢或丢数据。尤其是 getTableName() 的调用时机和 Db::name() 的校验，最容易在压测时才暴露。
