数据库连接失败需先核对host、port等配置，本地用localhost而docker或远程常需127.0.0.1；命令行能连但php报错则检查mysql扩展启用及selinux/防火墙；查询无结果应查错误信息，注意字段拼写、大小写、类型匹配；中文乱码须统一数据库、连接、文件三处utf8mb4字符集；慢查询需开慢日志并用explain分析索引使用；事务务必用try-catch确保commit或rollback。
连接失败：检查配置与网络通路
数据库连接不上是最常见的问题。先确认 host、port、username、password、database name 是否完全匹配实际环境。本地开发用 localhost，但 Docker 或远程服务器常需改用 127.0.0.1 或具体 IP——因为 localhost 在某些 MySQL 配置下会强制走 socket 连接，而 PHP 可能未启用该模式。
用命令行快速验证连通性：mysql -h 127.0.0.1 -P 3306 -u your_user -p
如果命令行能连上，但 PHP 报错，大概率是 PHP 的 MySQL 扩展未启用（检查 php.ini 中是否启用了 extension=mysqli 或 extension=pdo_mysql），或 SELinux / 防火墙拦截了 PHP 进程的出站连接。
查询无结果或报错：注意 SQL 语法与字符集
执行 SELECT 返回空数组，不一定是数据不存在。先用 var_dump($pdo->errorInfo()) 或 mysqli_error($link) 查看真实错误信息——常见如字段名拼错、表名大小写不符（Linux 系统下表名区分大小写）、WHERE 条件值类型不匹配（比如用字符串比较整数主键）。
中文乱码或插入失败？重点检查三处字符集是否统一：
- 数据库创建时指定 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
- 连接建立后立即执行 SET NAMES utf8mb4（PDO 可在 DSN 中加 ;charset=utf8mb4）
- PHP 文件本身保存为 UTF-8 无 BOM 格式
超时与性能卡顿：定位慢查询与资源瓶颈
页面加载几秒甚至超时，可能是单条 SQL 执行太久。开启 MySQL 慢查询日志（slow_query_log = ON，long_query_time = 1），再复现操作，查看日志中耗时 SQL。
常见低效写法包括：
- SELECT * 取大量无关字段
- 在 WHERE 或 ORDER BY 字段上缺失索引
- 使用 LIKE '%关键词%' 导致全表扫描
- 在循环里反复执行相同查询（N+1 问题）
用 EXPLAIN SELECT ... 分析执行计划，重点关注 type（尽量别是 ALL）、key（是否命中索引）、rows（扫描行数）。
立即学习“PHP免费学习笔记（深入）”；
事务异常与数据不一致：检查自动提交与错误处理
用了 $pdo->beginTransaction() 却没 commit() 或 rollback()，会导致连接一直占用、后续请求被锁住。更隐蔽的是：事务中某条语句失败，但代码没检测 $stmt->execute() 返回值或没捕获 PDOException，结果事务既没提交也没回滚。
安全写法示例：
try {
$pdo->beginTransaction();
$pdo->exec("UPDATE accounts SET balance = balance - 100 WHERE id = 1");
$pdo->exec("INSERT INTO logs (msg) VALUES ('deducted')");
$pdo->commit();
} catch (Exception $e) {
$pdo->rollback();
throw $e;
}
