thinkphp 多数据库适配需封装统一接口（如upsert）并自定义驱动：新建继承connection的驱动类，重写sql生成方法，在database.php配置并注册；禁用whereraw等裸sql，改用结构化查询；分库处理分页、排序、时间函数；事务嵌套前校验supportsavepoint()。
ThinkPHP 连接不同数据库时 SQL 语法报错怎么办
直接原因是 ThinkPHP 的 query() 或 execute() 方法绕过了 ORM 层，SQL 语句里用了 MySQL 特有语法（比如 INSERT ... ON DUPLICATE KEY UPDATE），但切换到 PostgreSQL 或 SQL Server 就直接抛异常。ORM 的 save()、replace() 看似跨库，实则底层驱动没做等价转换——MySQL 驱动里写了 REPLACE INTO，PgSQL 驱动根本不认这个关键词。
解决思路不是改 SQL，而是把数据库特有操作封装成统一接口。例如定义一个 upsert() 方法，在不同驱动里分别实现：
- MySQL 驱动里生成
INSERT ... ON DUPLICATE KEY UPDATE - PgSQL 驱动里生成
INSERT ... ON CONFLICT ... DO UPDATE - SQL Server 驱动里用
MERGE INTO+ 临时表模拟
关键点：不要在业务层拼 SQL 字符串，所有多库适配逻辑必须收口到驱动扩展中。
如何给 ThinkPHP 6 自定义数据库驱动并注册
ThinkPHP 6 的数据库驱动继承自 thinkdbConnection，新增驱动只需实现对应抽象方法，再在配置里声明类名即可。不建议修改框架源码，应通过 extend/ 目录注入。
实操步骤：
- 新建类
appextenddbpgsqlConnection，继承thinkdbConnection - 重写
getInsertSql()、getUpdateSql()等方法，处理 PgSQL 特有语法（如字段名需双引号包裹、无 LIMIT OFFSET 而是FETCH FIRST n ROWS ONLY） - 在
config/database.php中添加驱动配置：'pgsql' => ['type' => 'app\extend\db\pgsql\Connection'] - 使用时指定连接类型：
Db::connect('pgsql')->table('user')->select()
注意：ThinkPHP 默认不加载 extend/ 下的类，需在 composer.json 的 autoload.files 中手动加入自动加载路径。
ThinkPHP 的 Query 类方法在不同驱动下行为不一致
whereRaw()、fieldRaw() 这类“裸 SQL”方法最危险——它们完全跳过驱动的语法转义和参数绑定，MySQL 可能跑通，换到 SQLite 就因占位符格式（? vs :name）或字符串引号规则（单引号 vs 双引号）直接崩。
规避方式：
- 禁用
whereRaw()处理主键、时间、枚举等确定性条件；改用where('status', '=', 1)这类结构化调用 - 必须用原生 SQL 时，通过
$this->getConnection()->getBuilder()->parseKey()手动转义字段名，避免硬编码反引号或双引号 - 对分页、排序等高频差异点，封装
safeOrder()、safePage()工具方法，内部根据$this->getBuilder()->getDbType()分支处理
典型坑：SQLite 不支持 DATE_ADD(NOW(), INTERVAL 1 DAY)，但 ThinkPHP 的 whereTime() 在 SQLite 驱动里没重写，结果生成无效 SQL。
事务嵌套与保存点在多驱动下的兼容性问题
MySQL 支持 SAVEPOINT 和 ROLLBACK TO SAVEPOINT，PgSQL 也支持，但 SQL Server 的保存点语法是 SAVE TRANSACTION sp_name，且不支持在触发器内建保存点；SQLite 则根本不支持保存点嵌套。
如果你在业务里写了 $db->startTrans(); $db->transaction(function() { ... });，ThinkPHP 默认会尝试建保存点，但在 SQLite 下静默失败，后续 rollback() 可能回滚整个事务而非局部。
对策：
- 检查当前连接是否支持保存点：
$db->getBuilder()->supportSavepoint()返回true才执行嵌套事务 - 对不支持的驱动（如 SQLite），降级为“应用层标记 + 手动清理”模式，避免依赖数据库级保存点
- 永远不要假设
rollback()是局部的——加日志记录实际回滚范围，尤其在混合部署（开发用 SQLite、生产用 MySQL）场景下
最易被忽略的是驱动未显式声明保存点能力。即使你扩展了 PgSQL 驱动，若没重写 supportSavepoint() 方法返回 true，框架仍按不支持处理。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
