tp6数据库连接报错需分三层排查：先确认.env配置是否生效，再用原生pdo直连验证环境，最后根据错误码精准定位——connection refused、access denied、base table not found分别对应服务/网络、权限、表名问题。
TP6 接口数据库连接报错，核心要分三层排查：配置是否生效、连接能否建立、SQL 是否能执行。不是所有报错都代表连不上，有些是配置覆盖没生效或错误被静默吞掉。
先确认 .env 是否真正起作用
TP6 优先读取 .env 文件，而不是 config/database.php。常见问题：文件名写成 .env.example 或权限不足导致无法读取；或者没重启服务（尤其使用 Swoole 或 FPM 时，.env 修改后需重载）。
- 检查项目根目录是否存在
.env，且内容含DB_HOST=127.0.0.1、DB_PORT=3306、DB_NAME=test等完整字段 - 运行
php think env:show（需安装 think-env 扩展）或在控制器里打印env('DB_HOST')验证值是否被正确加载 - 若用 Docker，确保
.env已挂载进容器，且不是只存在于宿主机
直连验证绕过框架干扰
用原生 PDO 或对应驱动直接连接，能快速判断是 TP6 配置问题，还是环境/网络/权限问题。
- MySQL：运行
php -r "$pdo = new PDO('mysql:host=127.0.0.1;port=3306;dbname=test', 'root', '123456'); echo 'OK';" - PostgreSQL：
php -r "$pdo = new PDO('pgsql:host=127.0.0.1;port=5432;dbname=test', 'postgres', '123456'); echo 'OK';" - SQL Server：
php -r "$conn = sqlsrv_connect('192.168.1.100', ['UID'=>'sa','PWD'=>'123456','Database'=>'test']); var_dump($conn);"
成功则说明服务、账号、网络都通，问题大概率出在 TP6 的 DSN 构造或配置加载环节。
看具体报错类型对症处理
不同错误码指向完全不同的原因，别统一改 timeout 或重试：
- Connection refused → MySQL 服务未运行、端口被防火墙拦截、host 写成 localhost 但 MySQL 绑定的是 127.0.0.1（或反之）
- Access denied for user → 用户名密码错，或该用户没被授权访问目标库（注意 host 是 % 还是 localhost）
- Base table or view not found → 连接成功，但表名/库名拼写错误，或当前用户无权限查该表
-
SQLSTATE[HY000]: General error 2503 → 多见于手动调用
$this->query()执行写操作，应改用Db::execute() -
no pg_hba.conf entry（PG）→ PostgreSQL 拒绝连接，需修改
pg_hba.conf加白名单
连接池与超时配置别踩坑
TP6.1+ 启用连接池后，很多超时参数才真正生效，老版本配了也无效：
- 建连超时必须加在 DSN 里：
mysql:host=192.168.1.100;connect_timeout=3，仅靠params => [PDO::ATTR_TIMEOUT => 2]不管用 -
get_timeout是“从连接池取连接”的等待时间，单位毫秒，只在连接池满时触发 - TP6 默认不自动重连，
break_reconnect => true仅用于主从切换失败兜底，不能解决MySQL server has gone away
