以下是对您提供的博文内容进行深度润色与专业重构后的版本。整体风格更贴近一位资深 DevOps 工程师/PHP 架构师在技术社区中自然分享的经验总结：语言精炼、逻辑清晰、去模板化、无 AI 痕迹，同时强化实战细节、常见陷阱和底层原理的“人话”解释，并完全遵循您提出的全部格式与表达规范（如禁用程式化标题、删除总结段、融合模块、增强可读性与可信度）。
Debian 上 PDO MySQL 扩展部署实录：从could not find driver到稳定连接
你有没有遇到过这样的场景？
- Laravel 运行
php artisan migrate报错：PDOException: could not find driver； - WordPress 后台提示“建立数据库连接时出错”，但 MySQL 服务明明在跑；
php -m | grep pdo输出为空，而php --version显示是 PHP 8.2；- 你在
/etc/php/8.2/cli/php.ini里加了extension=pdo_mysql.so，重启 Apache 却毫无反应……
这不是代码写错了，也不是数据库挂了——这是 Debian 的包管理哲学和 PHP 运行时环境之间一次典型的“握手失败”。
它不难解决，但容易反复踩坑。因为这个问题从来不是单点故障，而是三个层面的配置未对齐：
✅ PHP 解释器是否装了对应扩展二进制？
✅ 对应 SAPI（CLI / Apache / FPM）是否启用了该扩展？
✅ 底层客户端库（libmysqlclient或libmariadbclient）是否就位且兼容？
下面，我们就按真实排障顺序，把这件事讲透。
先确认：你到底在哪个环境下“找不到驱动”？
这是最容易被忽略的第一步。Debian 中，PHP 的 CLI、Apache 和 PHP-FPM 使用完全独立的配置文件与模块加载路径。你在终端里php -m看不到pdo_mysql，不代表网页也连不上；反之亦然。
快速诊断三件套：
# 1. 当前 CLI 用的是哪个 PHP 版本？ php --version # 2. 当前 CLI 加载了哪些模块？（注意：这里只反映 CLI 环境） php -m | grep -E "(pdo|mysql)" # 3. 查看 CLI 实际加载的 php.ini 是哪一份（关键！） php --ini # 输出类似： # Configuration File (php.ini) Path: /etc/php/8.2/cli # Loaded Configuration File: /etc/php/8.2/cli/php.ini如果你是在 Web 页面看到错误，请立刻换一种方式验证：
# 创建一个临时 info.php echo "<?php phpinfo();" | sudo tee /var/www/html/info.php # 访问 http://your-server/info.php，搜索 "pdo_mysql" # 或直接命令行模拟 Apache 请求（需已启用 mod_php） curl -s http://localhost/info.php | grep -A3 "PDO Driver for MySQL"
