ThinkPHP数据库配置避坑：PDO扩展缺失导致的连接异常解答【解答】

先说几个关键点：ThinkPHP项目一运行就报“could not find driver”或“Class ‘PDO’ not found”，问题多半不在数据库配置本身，而是PHP环境根本没把pdo_mysql这个扩展给请出来。最让人头疼的是，命令行下测试得好好的，一上网页就崩——十有八九是命令行和Web服务用的是两套php.ini，其中一套忘了开这个驱动。

第一步：先确认PDO扩展到底在不在岗

在终端跑一下：php -m | grep -E "pdo|mysql"。输出结果会告诉你，PDO模块本身在不在，以及mysql驱动有没有跟着一起出来。如果只看到pdo但没有pdo_mysql，就说明扩展没被允许加载；要是连pdo的影子都没有，那主模块都没开。

接下来，新建一个测试文件info.php，里面就写，然后用浏览器访问它。在输出页面里搜索“Loaded Configuration File”，把那个真正生效的php.ini路径记下来。

【CLI和Web的扩展状态必须保持一致】这才是关键所在。你刚才在终端里看到的php -m结果只代表命令行PHP的环境。而ThinkPHP的网页请求走的是PHP-FPM或Apache模块，它读的是phpinfo()里显示的那个php.ini。两个配置文件的extension=pdo_mysql.so（Linux/macOS）或extension=php_pdo_mysql.dll（Windows）都必须存在，而且前面没有分号注释掉。

Mac上启用pdo_mysql的两条路

方法一：用brew直接安装扩展（强烈推荐）
先确认你的PHP版本，比如是php@8.2，然后执行：brew install php@8.2-mysql。安装完，它会自动生成一个ini文件，通常藏在/opt/homebrew/etc/php/8.2/conf.d/ext-mysql.ini，你确认里面的内容是extension="pdo_mysql.so"就好（不带路径，PHP 7.4+会自动补全后缀）。

方法二：手动编辑php.ini（当brew没有自动生成ini时的备选方案）
用nano /opt/homebrew/etc/php/8.2/php.ini打开对应版本的php.ini，在;extension=那一段的最后新加一行：extension=pdo_mysql.so。必须注意的是，不要加引号，不要写绝对路径，更不要漏掉.so后缀——写成extension="pdo_mysql"或者自己拼个路径extension=/opt//pdo_mysql.so都会失败。

⚠️ 这里有个小陷阱：Mac上extension_dir默认指向的是/opt/homebrew/lib/php/pecl/20220829这种带数字后缀的目录。别自己编译个.so文件然后扔错目录。brew install会帮你把pdo_mysql.so放到正确的地方。

Linux系统快速补上PDO驱动

第一步：确认你的包管理器是哪种
Ubuntu/Debian用户跑：sudo apt update && sudo apt install php-pdo php-mysql
CentOS/RHEL用户跑：sudo yum install php-pdo php-mysqlnd（或者dnf install php-pdo php-mysqlnd）

第二步：检查php.ini是否已启用
通过php --ini查看CLI的配置路径，再用phpinfo()查看Web的配置路径。这两个文件里都必须有以下两行：
extension=pdo.so
extension=pdo_mysql.so
注意：是pdo_mysql，不是mysqli.so，也不是pdo_pgsql.so。

第三步：重启服务，验证成果
Ubuntu/Debian系统跑：sudo systemctl restart apache2 或 sudo systemctl restart php8.2-fpm
CentOS系统跑：sudo systemctl restart httpd 或 sudo systemctl restart php-fpm
重启完，刷新phpinfo()页面，搜索“PDO drivers”，确认列表里明确出现了一个mysql（小写、不带下划线、没有前缀）。

Windows下启用pdo_mysql的关键动作

打开php.ini，找到下面两行，把前面的分号去掉：
;extension=php_pdo.dll
;extension=php_pdo_mysql.dll

然后确认extension_dir指向的那个目录里，真实存在这两个.dll文件。常见错误是路径写对了，但php_pdo_mysql.dll文件根本没拷进去，或者文件名被错误地改成了php_pdo_mysql.dll.bak。

最后，别忘了重启Web服务（Apache/Nginx）或PHP-FPM进程，不然修改是不会生效的。

ThinkPHP中type字段写错的致命陷阱

在TP6+ 的config/database.php里，connections.default.type这个值必须是一个字符串，不能写成数组（比如['type' => 'mysql']这种写法是错的）。

这个type值不是随便起的数据库名，而是PDO扩展注册的驱动标识符，大小写、拼写、甚至下划线都极度敏感：
✅ 合法值只有这几个：'mysql'、'pgsql'、'sqlite'、'sqlsrv'、'oci'
❌ 下面这些坑千万不要踩：'MySQL'（大写）、'pdo_mysql'（带前缀）、'mysqli'（名字不对）、'mysql '（末尾多了一个空格）、"mysql"（双引号在某些旧版TP里会造成解析差异）。

只要写错一个字符，PDO就会直接抛出“Driver not found”，而且根本不会告诉你具体错在哪里。

最后一步：验证连接是否真的打通了

在项目根目录的终端里执行：mysql -h 127.0.0.1 -P 3306 -u root -p。这一步务必使用127.0.0.1，而不是localhost。因为在macOS/Linux下，localhost默认走Unix socket，容易和PHP的配置产生错位。

如果命令行能连上数据库，但ThinkPHP依旧报错，那问题肯定出在PHP环境或配置文件上。如果命令行本身就连不上，那就要先去检查MySQL服务有没有启动、端口有没有监听、以及用户权限是不是被限制了。

另外，别只盯着日志里那句含糊的“数据库连接失败”。直接去翻runtime/log/目录下的最新日志文件，找到包含PDOException的那一行，把完整的错误信息复制出来，这才是判断问题的唯一准确依据。