ThinkPHP 6.x 可复用 MySQL 驱动连接 AnalyticDB MySQL 版，需严格使用控制台提供的 endpoint 和端口（如3003/10024），显式配置 PDO 超时、禁用事务、规避不支持语法，并处理 DNS 缓存与连接空闲超时对齐。
ThinkPHP 6.x 连接 AnalyticDB MySQL 版：驱动与配置关键点
ThinkPHP 6 默认不内置 AnalyticDB MySQL 版专用驱动，但因其完全兼容 MySQL 协议（5.7+），可直接复用 mysql 或 mysqli 驱动，无需额外扩展包。重点在于连接参数必须匹配 AnalyticDB 控制台提供的实际值，尤其是端口和 host 格式。
常见错误是直接套用本地 MySQL 的 127.0.0.1:3306 配置，导致连接超时或拒绝。AnalyticDB MySQL 版的 endpoint 是形如 mydb-xxxx.ads-cn-hangzhou-1.aliyuncs.com 的域名，端口不是 3306 —— 实测常见为 3003（集群版）或 10024（Serverless 版），必须从控制台“连接信息”页复制，不能猜测。
- 在
config/database.php中使用mysql类型，hostname填控制台获取的完整 endpoint（不含协议） -
hostport必须显式指定，例如3003；不填则默认 3306，必然失败 -
database填你创建的数据库名（如ads_app_db），该库需已通过控制台或 SQL 编辑器完成初始化 - 用户名密码为控制台创建的高权限账号，非阿里云主账号 AK/SK
查询超时与长事务：AnalyticDB 的 timeout 设置必须显式调优
AnalyticDB MySQL 版对单条查询有默认执行时间限制（通常 300 秒），而 ThinkPHP 的 PDO 默认 timeout 可能远小于此值，导致查询中途被框架中断，报错类似 PDOException: SQLSTATE[HY000]: General error: 2013 Lost connection to MySQL server during query。
这不是网络问题，而是客户端主动断开。必须在数据库配置中显式扩大超时窗口，并禁用自动 commit（因 AnalyticDB 不支持事务回滚语义）：
立即学习“PHP免费学习笔记（深入）”；
- 在
database.php的mysql配置块中添加：'params' => [PDO::ATTR_TIMEOUT => 300] - 同时设置
'deploy' => 0, 'strict' => false, 'auto_close' => false，避免框架在查询后强制关闭连接 - 禁用事务包装：所有分析类查询应走
Db::raw()或原生query()，避免startTrans()等操作
SQL 兼容性陷阱：AnalyticDB 不支持的 MySQL 语法要主动规避
AnalyticDB MySQL 版虽标称兼容 MySQL 5.7，但实际去除了部分 OLTP 场景功能，比如存储过程、触发器、外键约束、全文索引（FULLTEXT）、某些窗口函数（如 RANK() OVER (ORDER BY ...) 在旧版本受限）。ThinkPHP 的 with() 关联查询若生成了子查询嵌套过深或含不支持函数，会直接报错 ERROR 1064 (42000): You have an error in your SQL syntax。
建议策略是收口分析 SQL 到视图或原生查询，而非依赖 ORM 自动生成：
- 禁用
think-model的复杂关联，改用Db::query('SELECT ... FROM ads_table JOIN ...') - 避免
GROUP_CONCAT超长截断：AnalyticDB 默认group_concat_max_len=1024，需在连接后执行SET SESSION group_concat_max_len = 1048576 - 日期函数优先用
NOW()、CURDATE()，慎用SYSDATE()（行为可能不一致）
生产环境连接池与 DNS 缓存：别让 PHP-FPM 进程反复解析 endpoint
在高并发场景下，每个 PHP-FPM worker 进程首次连接 AnalyticDB 时都会触发 DNS 解析。若 endpoint 对应的 IP 频繁变更（如弹性扩缩容），未启用 DNS 缓存会导致大量 php_network_getaddresses: getaddrinfo failed 错误。
ThinkPHP 自身不管理 DNS 缓存，需系统层干预：
- 在服务器部署
nscd或systemd-resolved并启用缓存，避免每次请求都走公网 DNS - 连接字符串中不要用
localhost或内网 IP 替代 endpoint —— AnalyticDB 的负载均衡逻辑依赖域名路由 - 若使用连接池（如 Swoole + think-swoole），必须确保
mysql连接在 worker 启动时预热，而非按需创建
最易被忽略的是：AnalyticDB MySQL 版的连接空闲超时默认为 300 秒，而 PHP 的 mysqlnd 默认 wait_timeout 是 28800 秒。两者不匹配时，连接池中的“健康连接”可能已被服务端静默断开，下次复用即失败。务必在连接建立后执行 SET SESSION wait_timeout = 28800 对齐。
