ThinkPHP连接不同类型数据库时的常见报错解决-ThinkPHP-PHP中文网

thinkphp连接数据库报错根源主要是驱动不匹配或dsn格式不兼容：mysql连不上需查pdoexception message并手动测试mysql命令；postgresql dsn必须完整含port、dbname且驱动为pdo_pgsql；sqlite路径须绝对且权限正确；sql server需严格匹配扩展版本与协议配置。

thinkphp连接不同类型数据库时的常见报错解决

ThinkPHP 连接不同数据库时，报错根源几乎都落在「驱动不匹配」或「DSN 格式不兼容」上，而不是配置项写错了——比如用 pdo_mysql 驱动连 PostgreSQL，或把 SQLite 的 database 当成 MySQL 的库名来填。

MySQL 连不上：先看 PDOException message，别改 config/database.php 就跑

报错里带 SQLSTATE[HY000] [1045] 或 [2002]，说明 PDO 层根本没连通。这时候改 username、password 可能白忙，因为真实问题在连接路径上：

用 mysql -h 127.0.0.1 -P 3306 -u root -p 手动测试，确认 MySQL 服务开着、端口通、账号能登录
hostname 写 localhost 时，Linux/macOS 下可能走 Unix socket，但 ThinkPHP 默认走 TCP；若 MySQL 没开 bind-address = 127.0.0.1，就会静默失败
Docker 环境下，hostname 不能写 127.0.0.1，得换成容器名（如 mysql）或宿主机网关（host.docker.internal）
MySQL 8.0+ 用户报 caching_sha2_password 错误，不是降级，而是执行：ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pass';

PostgreSQL 报错 “could not connect to server”：DSN 必须显式带 port 和 dbname

ThinkPHP 对 PostgreSQL 的 DSN 解析比 MySQL 更严格，漏掉任意一项都会直接抛出连接拒绝错误：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

驱动必须是 pdo_pgsql，不是 pgsql 或 pdo_mysql
dsn 字段必须完整，例如：pgsql:host=127.0.0.1;port=5432;dbname=testdb;user=postgres;password=123 —— 缺 port 或 dbname 就会卡在 could not connect to server
PostgreSQL 默认关闭远程连接，需检查 postgresql.conf 中 listen_addresses = 'localhost'（或 '*'），以及 pg_hba.conf 是否允许对应用户从 PHP 所在 IP 登录
用户名密码含特殊字符（如 @、/）时，必须 URL 编码后填入 DSN，否则解析失败

SQLite 报错 “no such table” 或 “unable to open database file”：路径和权限是关键

SQLite 不走网络，所有问题都出在文件路径和 PHP 进程权限上：

database 配置项必须是绝对路径，相对路径（如 ./runtime/db.sqlite）在 CLI 和 Web 环境下解析基准目录不同，极易失效
确保 PHP 进程对文件及其所在目录有读写权限：chown www-data:www-data /path/to/db.sqlite && chmod 644 /path/to/db.sqlite
如果用 Db::name('user')->find() 报 no such table，不是表不存在，而是当前连接的 SQLite 文件压根没加载成功（日志里会有 unable to open database file）
ThinkPHP 不支持 SQLite 的内存模式（:memory:），填进去会静默失败，不要试

SQL Server（pdo_sqlsrv）连不上：Windows + PHP 扩展缺一不可

这个组合最容易卡在环境层，报错常是 Call to undefined function sqlsrv_connect() 或 Unable to connect：

Linux 下无法直接用 pdo_sqlsrv，必须用 pdo_odbc + unixODBC 配置，且 DSN 要写成：odbc:Driver={ODBC Driver 17 for SQL Server};Server=xxx;Database=xxx;
Windows 下必须启用 extension=php_pdo_sqlsrv.dll 和 extension=php_sqlsrv.dll，且版本要跟 PHP 主版本（如 8.1）、线程安全（TS/NTS）完全一致
SQL Server 默认禁用 TCP/IP 协议，需在 SQL Server Configuration Manager 中启用，并确认 SQL Server Browser 服务运行中
连接字符串里的 Server 值不能只写实例名（如 MYPC\SQLEXPRESS），得补全端口：Server=MYPC\SQLEXPRESS,1433，否则 Windows 下容易超时