ThinkPHP连接RDS失败的根本原因是数据库地址硬编码在.env或config/database.php中，未随RDS网络切换动态更新；应优先使用.env管理DB_HOST，结合CI/CD或容器环境变量注入，并清除runtime/cache避免缓存旧配置。
ThinkPHP 项目连接 RDS 后，只要 .env 或 config/database.php 里用的是硬编码的内网地址（比如 10.10.10.10），网络一变就断——这不是代码问题，是配置没解耦。
为什么改了 RDS 地址，ThinkPHP 还连不上？
常见现象是：RDS 切换到 VPC 后，旧经典网络地址失效，但 PHP 报错不是 “Connection refused”，而是 PDOException: SQLSTATE[HY000] [2002] Connection refused 或更隐蔽的超时。根本原因不是数据库挂了，而是 ThinkPHP 加载的数据库配置仍指向已下线的 IP。
- ThinkPHP 读取数据库配置的优先级是：
.env>config/database.php> 默认值；如果.env里写了DB_HOST=10.10.10.10，哪怕 RDS 控制台显示新地址是rm-xxx.mysql.rds.aliyuncs.com，它也绝不自动更新 - 有些项目把
DB_HOST写死在config/database.php里，且用了php think optimize:config缓存了配置，导致改了.env也不生效 - RDS 开启混访后，虽然新旧地址共存，但部分 ECS 实例（尤其是老批次）可能因安全组或路由策略，只通新地址、不通旧地址——这时你以为“还能连”，其实只是部分请求侥幸成功
如何让 ThinkPHP 自动适配 RDS 地址变更？
核心思路：把地址从代码/配置文件里抽出来，交由环境或服务发现机制控制。不推荐“改完立刻上线”，而应支持灰度切换。
- 强制使用
.env管理所有数据库连接参数，删掉config/database.php中的'hostname' => '10.10.10.10'这类硬编码，改用env('DB_HOST', 'localhost') - 在部署流程中，用 CI/CD 脚本动态写入
.env：例如 Jenkins 构建时根据当前环境变量ENV=prod注入对应 RDS 地址，避免人工编辑出错 - 若用容器化（Docker/K8s），直接通过
environment:或 ConfigMap 注入DB_HOST，完全绕过本地配置文件 - 对必须保留双地址的混访期，可加一层简单判断逻辑：
env('DB_HOST_FALLBACK') ? env('DB_HOST_FALLBACK') : env('DB_HOST')，并在应用启动时用$this->db->connect()主动探测连通性，失败则 fallback（注意别在每次查询前都探测）
迁移时 runtime/cache 和迁移命令的坑
很多人在 RDS 切换后顺手执行 php think migrate:run，结果报错 Class 'think\migration\Command' not found 或 No migrations to run——这和数据库地址无关，是缓存和路径问题。
立即学习“PHP免费学习笔记（深入）”；
- 执行迁移前，先清空
runtime/cache/目录，否则旧的配置缓存（含老 DB_HOST）可能被think\migration加载器误用 - 确认迁移扩展已安装且注册：
composer require topthink/think-migration:^4.0（TP6/TP7），并在config/console.php的'commands'数组中明确加入'\think\migration\Command::class' - 迁移文件必须放在
database/migrations/（不是migrate/或database/migrate/），且文件名以 14 位时间戳开头，例如20260521000000_update_rds_connection.php - 不要在迁移中调用模型或事件——
UserModel::where(...)->update()这类操作在迁移上下文里极可能因连接未初始化或模型未加载而崩溃
最易被忽略的一点：RDS 混访期结束后，经典网络地址会自动释放，但 ThinkPHP 应用若没做连接池健康检查或重连机制，可能出现偶发性连接失败却无日志——建议在 app/middleware.php 或数据库中间件中加一条 try { $this->db->query('SELECT 1'); } catch (...) { Log::error('DB unreachable after RDS migration'); }，早于业务逻辑暴露问题。
