PDO扩展启用需同时满足：php -m或PDO::getAvailableDrivers()确认pdo及对应驱动（如pdo_mysql）已加载；MySQL连接DSN须含charset=utf8mb4且options设SET NAMES；PostgreSQL DSN严禁charset字段；Oracle DSN格式必须严格匹配；连接后需用getAttribute验证状态并启用异常模式。
确认PDO扩展是否启用
运行 php -m | grep pdo，输出中必须同时包含 pdo 和对应数据库驱动（如 pdo_mysql、pdo_pgsql），缺一不可。
Linux 下未启用时执行 sudo apt install php-pgsql（PostgreSQL）或 sudo apt install php-mysql（MySQL），Windows 则检查 php.ini 中 extension=php_pdo_mysql.dll 是否取消注释；若仍报错，用 php -r "print_r(PDO::getAvailableDrivers());" 验证真实可用驱动列表——这个输出才是 PDO 实际加载结果，比 php -m 更可信。
检查连接参数是否完整且格式合法
MySQL 连接必须同时满足两项硬性条件：【DSN 字符串含 charset=utf8mb4】，例如 "mysql:host=127.0.0.1;dbname=test;charset=utf8mb4"；【options 数组含 PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES utf8mb4'】，否则 emoji 插入失败、JSON 字段静默截断等异常不会报错，只会数据异常。
PostgreSQL 连接严禁出现 charset 键，写了就导致 PDO 构造失败，表现是“连接成功但查表抛空异常”，日志里看不到真实错误；正确 DSN 应为 "pgsql:host=127.0.0.1;dbname=myapp;user=postgres;password=xxx"，不含任何 charset 字段。
立即学习“PHP免费学习笔记（深入）”；
Oracle OCI 连接对格式零容忍：DSN 必须是 "oci:dbname=//127.0.0.1:1521/ORCL;charset=UTF8"（注意双斜线、服务名大小写、UTF8 不能小写），漏掉任意一项直接触发 ORA-12154，不是网络问题，是 PDO 初始化阶段崩溃。
验证连接是否真正建立并复用
第一步：在控制器中插入测试代码：
try { $pdo = new PDO($dsn, $user, $password, $options); var_dump($pdo->getAttribute(PDO::ATTR_CONNECTION_STATUS)); } catch (PDOException $e) { echo $e->getMessage(); }
第二步：若输出非 Connection OK，说明连接未建立；若输出为空或报错，检查 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION 是否已设——没设此项，PDO 会静默失败，fetch() 直接返回空数组，调试时根本看不出哪错了。
第三步：在 FPM 环境下，确认配置中未误加 'pool' => true 或 'persistent' => true；TP8 在 FPM 下不支持连接池，该配置被完全忽略，Db::connect() 每次新建 PDO 实例，异常中断会导致连接卡在 MySQL 的 Sleep 状态不释放。
捕获并定位真实异常源头
方法一：强制开启 PDO 异常模式。在 DSN 创建前加入 if (!defined('PDO::ATTR_ERRMODE')) { die('PDO extension not loaded'); }，避免因扩展缺失导致后续逻辑跳过错误检测。
方法二：在 try-catch 中打印完整异常链：echo $e->getMessage() . "\n" . $e->getTraceAsString();，特别关注 message 末尾的 (using password: YES/NO)——YES 表示密码错或用户不存在，NO 表示 DB_PASSWORD 为空、null 或被 trim 成空字符串。
方法三：绕过框架直连验证。新建独立 PHP 文件，仅用原生 PDO 初始化，排除 ThinkPHP 配置覆盖干扰；若原生可连而 TP8 不行，立即检查 config/database.php 中 connections 键名是否与 Db::connect('xxx') 中的字符串**完全一致**（大小写、下划线、空格全敏感）。
