tp5.1数据库平滑切换需采用双写+增量同步+校验+渐进切换，不可仅改config/database.php；须手动在业务层实现双写逻辑，通过独立连接配置、trait封装savetoboth()、放弃跨库事务、读操作暂不切新库，并用分块md5比对校验一致性。
TP5.1 项目做数据库平滑切换，不能靠改 config/database.php 一锤定音。真要零停机、业务无感，必须走「双写 + 增量同步 + 校验 + 渐进切换」这条路。直接切连接，90% 的概率会丢数据或报错。
TP5.1 如何实现双写逻辑（非中间件方案）
ThinkPHP 5.1 本身不内置双写能力，得在业务层手动控制。核心是：所有涉及写操作（insert、update、delete）的 Model 或 Service，都要显式调用两个库。
- 不要依赖全局配置切换，而是为新库单独定义一个数据库连接配置项，比如在
config/database.php中加一段：'db_new' => [ 'type' => 'mysql', 'hostname' => 'new-db-host', ... ] - 写操作时，先用默认连接执行旧库操作，再用
Db::connect('db_new')执行相同 SQL；注意事务无法跨库，所以得放弃事务包裹双写，改用最终一致性补偿（比如失败后记录日志+重试队列） - 避免在控制器里硬编码双写逻辑，建议封装成 Trait，例如
DoubleWriteTrait，统一提供saveToBoth()方法，降低散落风险 - 读操作仍只走旧库，直到校验完成、流量切换完成——这点容易被忽略，过早读新库会导致脏读或空数据
为什么 pt-table-checksum 不适用于 TP5.1 双写校验
pt-table-checksum 是为 MySQL 主从设计的，依赖 Binlog 和从库复制延迟检测机制。TP5.1 双写场景下，新库不是从库，没有复制关系，直接跑这个工具会报错或校验失效。
ThinkPHP 8.1.0
下载
ThinkPHP 8.1.0 正式发布，深度优化路由与验证机制，完美兼容 PHP 8.4。本版本修复了数组路由配置异常，新增枚举值校验与高级数组验证功能，支持路由分类默认处理。作为高性能 PHP 框架的最新迭代，它延续了简洁实用的设计原则，提供更稳定的底层架构与更流畅的开发体验，助力开发者快速构建现代化 Web 应用与企业级系统。
- 真实可行的校验方式是：对关键表按主键分块，分别查旧库和新库的
SELECT MD5(CONCAT(...))聚合值，比对哈希是否一致 - TP5.1 中可写个命令行指令（
php think check:consistency --table=user --chunk=1000），用Db::query()分批拉取并计算，避免内存溢出 - 校验过程必须避开业务高峰，且每次校验后要记录 checkpoint（如最后校验的主键 ID），否则重复校验浪费资源
- 发现不一致时，优先查双写日志（比如记录每条写操作的 SQL、参数、时间戳），而不是盲目重推全量
切换连接时 DNS 和配置中心怎么配合 TP5.1
TP5.1 默认不支持运行时热更新数据库配置，所以不能只靠改配置文件。DNS 切换快但不可控，配置中心更稳但需改造。
- DNS 方案：把旧库和新库都指向同一个域名（如
db-api.example.com），迁移前解析到旧 IP，校验完成后一键切到新 IP；但要注意 TTL 缓存，提前设成 60 秒以下，并确认所有 PHP 进程已清 DNS 缓存（clearstatcache(true)不管用，得重启 php-fpm 或用dns_get_record()强制刷新） - 配置中心方案：用 Consul 或 Nacos 管理
database.hostname，TP5.1 启动时从配置中心拉取；需改造think\db\Connection类，在initConnect()前加一层代理，定期轮询配置变更并重建连接池——别试图 reload config 文件，TP5.1 的连接池不会自动更新 - 无论哪种方式，切换后必须立刻验证：查新库是否有最新写入（比如刚下单的订单号是否存在）、查慢查询日志是否突增（说明索引没建好或 SQL 兼容性出问题）
真正难的不是写双写代码，而是识别哪些表必须强一致（比如账务表）、哪些可以容忍几秒延迟（比如日志表），以及如何让开发团队在双写期间不绕过封装直接调 Db::name()->insert()。这些细节没卡死，再漂亮的架构也会在上线前崩掉。
