ThinkPHP可直连GoldenDB，前提是启用MySQL兼容模式、认证插件降级为mysql_native_password、hostname填计算节点内网IP，并在params中设sql_mode和ATTR_EMULATE_PREPARES。
ThinkPHP 能直接连 GoldenDB，不需要改驱动或写新 connector，前提是 GoldenDB 实例已启用 MySQL 兼容模式（默认就是），且 PHP 的 mysqlnd 扩展正常、MySQL 8.0+ 认证插件已降级为 mysql_native_password。它不是“需要适配”的数据库，而是“开箱即用但容易踩配置坑”的数据库。
GoldenDB 连接失败的典型错误和真实原因
报错如 SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client 或 Connection refused，基本都不是 GoldenDB 自身不兼容，而是以下三者之一：
- MySQL 8.0+ 默认认证插件
caching_sha2_password不被 PHP 7.x 的mysqlnd支持 —— 必须在 GoldenDB 中执行ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pwd'; FLUSH PRIVILEGES; -
hostname填了公网地址但安全组没放行 3306，或未配置 GoldenDB 集群节点间互通（GoldenDB 是多节点部署，客户端必须能直连计算节点 IP） -
type在database.php里写成'Type' => 'MySQL'—— ThinkPHP 驱动注册名严格小写，必须是'type' => 'mysql'
database.php 中最关键的三项配置
GoldenDB 官方明确声明完全兼容 MySQL 协议与语法，所以 ThinkPHP 6/8 的原生 mysql 驱动可直接使用，但以下参数不可省略或错配：
-
'hostname'必须是 GoldenDB 计算节点（Compute Node）的真实内网 IP，不是 VIP 或管理地址；多个节点需手动做负载或高可用，TP 不内置 GoldenDB 多节点发现逻辑 -
'params'中建议显式关闭严格模式：加入\PDO::MYSQL_ATTR_INIT_COMMAND => "SET sql_mode = 'NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION'"，避免GROUP BY或空字符串插入 datetime 字段时报错 -
'charset'推荐设为'utf8mb4'，GoldenDB 对 emoji 和四字节 UTF-8 支持完整，但若建库时用了utf8（实际是 utf8mb3），则此处必须匹配，否则连接后查中文可能乱码
为什么 Db::name('xxx')->select() 返回空数组？
这不是连接失败，而是字段元信息解析异常，常见于两种情况：
立即学习“PHP免费学习笔记（深入）”；
- GoldenDB 开启了 SQL 审计或透明加密模块，导致
DESCRIBE table_name返回结构与标准 MySQL 不一致 —— 此时需在database.php中启用'debug' => true，观察日志里是否卡在getFieldsType阶段 - 未启用
\PDO::ATTR_EMULATE_PREPARES => true—— GoldenDB 的预处理协议实现对某些 PDO 字段类型映射有偏差，加上这一项可强制走模拟预处理，绕过底层类型识别问题
多库共存时的命名冲突风险
GoldenDB 支持同实例下多 database，但 ThinkPHP 的 Db::connect('goldendb_prod') 和 Db::connect('goldendb_test') 若共用同一套连接参数（仅 database 名不同），要注意：
- 连接池不会区分
database名，两次connect()可能复用同一个物理连接，导致后续查询意外落在前一个库上 - 解决方式：每个连接必须配置独立的
'hostname'+'port'（哪怕指向同一节点），或启用'break_reconnect' => true强制每次新建连接 - 更稳妥的做法是：用
Db::connect(['database' => 'prod_db'])动态传参，而非预定义多个命名连接
GoldenDB 最容易被忽略的一点是：它没有“自动创建库”能力。ThinkPHP 的 db:seed 或迁移命令如果带 CREATE DATABASE，会直接报错 —— 所有 database 必须提前在 GoldenDB 控制台或 gsql 工具中手动创建，且字符集、排序规则要与 PHP 连接参数一致。
