ThinkPHP连接数据库报错根源主要是驱动不匹配或DSN格式不兼容：MySQL连不上需查PDOException message并手动测试mysql命令；PostgreSQL DSN必须完整含port、dbname且驱动为pdo_pgsql；SQLite路径须绝对且权限正确；SQL Server需严格匹配扩展版本与协议配置。
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 更严格，漏掉任意一项都会直接抛出连接拒绝错误：
- 驱动必须是
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 进程权限上：
立即学习“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 下容易超时
跨数据库切换时最易忽略的是驱动扩展是否真的加载成功，而不是配置是否“看起来对”。用 php -m | grep sqlsrv 或 phpinfo() 查扩展状态，比反复改 database.php 有效得多。
