ThinkPHP配置TiDB数据库：分布式NewSQL在ThinkPHP中的无缝接入体验-ThinkPHP-PHP中文网

tidb在thinkphp中需配置charset=>'utf8mb4'、hostport=>'4000'、deploy=>0、params加入pdo::attr_emulate_prepares=>false及pdo::mysql_attr_init_command=>"set tidb_skip_utf8_check=1"，事务须显式控制、拆分小事务并避免ddl操作。

thinkphp配置tidb数据库：分布式newsql在thinkphp中的无缝接入体验

TiDB 在 ThinkPHP 中无需特殊适配，直接按 MySQL 配置就能用，但有几个关键点不处理就会连不上、事务异常或查询变慢。

ThinkPHP 的 `database.php` 配置怎么写才兼容 TiDB

TiDB 兼容 MySQL 5.7 协议，所以 ThinkPHP 默认的 mysql 驱动完全可用，但不能照搬旧项目配置。常见错误是沿用 charset => 'utf8' 或忽略 deploy 和 params 的影响：

charset 必须设为 'utf8mb4'，TiDB 默认不支持 utf8（它只是 MySQL 的别名，实际是 utf8mb3）
deploy 建议显式设为 0，即使你部署了 TiDB 多节点，ThinkPHP 的 deploy=1 主从逻辑和 TiDB 的 PD/TiKV 架构不匹配，反而干扰连接路由
params 中建议加入 PDO::ATTR_EMULATE_PREPARES => false，否则预编译语句可能被 PHP 模拟执行，绕过 TiDB 的 Prepare Plan Cache，影响性能
端口别写死 3306，TiDB Server 默认是 4000，配置里要对应上：'hostport' => env('DB_PORT', '4000')

为什么 `Db::transaction()` 在 TiDB 里容易报错或超时

TiDB 的事务模型和 MySQL 不同：它基于 Percolator 协议，两阶段提交 + 乐观锁，不支持长事务、也不允许在事务中执行 DDL。ThinkPHP 默认事务行为在 TiDB 上容易触发 ERROR 9001 (HY000): PD server timeout 或 ERROR 8028 (HY000): Information schema is changed：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

避免在事务内调用 Db::table()->schema() 或任何会触发 SELECT @@version 的操作
显式控制事务生命周期，别依赖 __destruct 自动提交；用 try/catch 包裹，并在 catch 中明确 Db::rollback()
把大事务拆成多个小事务，TiDB 推荐单事务内修改行数
如果必须长事务（比如导出类场景），改用 START TRANSACTION WITH CONSISTENT SNAPSHOT 原生 SQL 启动，再用 Db::raw() 执行

使用 `ThinkORM` 模型时，`auto_timestamp` 和 `datetime_format` 怎么配合 TiDB 的时间类型

TiDB 的 DATETIME 和 TIMESTAMP 行为与 MySQL 有细微差异，尤其在时区和默认值上。ThinkPHP 的自动时间戳功能若不调整，会导致插入 NULL 或时区偏移：

auto_timestamp 设为 true 是安全的，但字段类型推荐统一用 DATETIME(6)（带微秒），TiDB 对 TIMESTAMP 的自动时区转换更敏感
datetime_format 建议保持默认 'Y-m-d H:i:s'，不要加毫秒（如 'u'），否则 ORM 写入时可能因精度截断触发 TiDB 的严格模式报错
如果数据库字段定义了 DEFAULT CURRENT_TIMESTAMP，ThinkPHP 的 auto_timestamp 会和 TiDB 的默认值冲突，此时应关掉 ORM 自动写入，靠数据库侧兜底
测试时注意连接参数是否含 time_zone='+00:00'，否则 now() 和 PHP date() 可能对不上

连接池、断线重连和监控埋点要注意什么

ThinkPHP 自带的 break_reconnect 在 TiDB 场景下效果有限——TiDB Server 是无状态的，但 PD 调度或 TiKV 节点抖动会导致连接被主动中断。光靠重连不够：

break_reconnect 可开启，但必须配合 'params' => [PDO::ATTR_TIMEOUT => 3]，否则重连等待太久，拖垮整个请求
生产环境建议在 params 中加上 PDO::MYSQL_ATTR_INIT_COMMAND => "SET tidb_skip_utf8_check = 1"，避免大批量导入时因字符校验失败中断
监控不能只看 Db::getLastSql()，TiDB 的执行计划需通过 EXPLAIN FORMAT='VERBOSE' 查看，ThinkPHP 的 ->fetchSql() 不支持这个语法，要用 Db::raw() 替代
如果用了 TiDB 的绑定变量特性（PREPARE/EXECUTE），确认 ThinkPHP 版本 ≥ v8.0.40，早期版本存在 bindParam 类型推断错误导致数字被转成字符串的问题