PHP 数据库连接失败时，光靠 echo 或屏幕报错远远不够，必须把异常信息可靠地记录下来，才能快速定位是网络中断、密码错误、服务宕机，还是配置写错了。
用 try-catch 捕获 PDO 异常并写入日志文件
PDO 默认不抛出异常，需显式开启 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION。捕获后，不应直接输出敏感信息（如密码、完整 DSN），而应提取关键字段记录到日志中：
- 记录时间、错误码（
$e->getCode()）、SQLSTATE（$e->getSQLState()）和简洁消息（$e->getMessage()） - 避免记录完整 DSN，可只记数据库名、主机和端口，例如：
mysql:host=10.0.1.5;port=3306;dbname=app_db - 使用
error_log()写入指定文件，或调用自定义日志函数（如基于 Monolog 的封装）
区分连接异常与查询异常，针对性记录
连接失败（如 host 不通、认证拒绝）和查询执行失败（如语法错误、锁超时）的排查路径不同，日志中应明确标识类型：
- 连接异常通常发生在
new PDO(...)时，$e->getSQLState()常为08001（无法连接）或28000（访问拒绝） - 查询异常多出现在
$pdo->query()或$stmt->execute()阶段，SQLSTATE 可能是42000（语法错误）或HY000（死锁） - 可在日志前缀中打标：[CONNECT ERROR] 或 [QUERY ERROR]，便于 grep 或日志系统分类
避免日志被刷爆：加简单限流与上下文隔离
若数据库彻底不可用，每次请求都尝试连接并记日志，可能在几秒内生成数百条重复日志。可做轻量控制：
立即学习“PHP免费学习笔记（深入）”；
- 对同一类连接错误（如相同 host+port 认证失败），在 60 秒内最多记录 3 次，用内存/Redis 缓存最近错误指纹（如 md5(host:port:code)）
- 每个请求的日志行带上唯一 request_id（如来自
uniqid('req_')），方便关联 Web 日志与 DB 日志 - 生产环境禁用
display_errors = On，确保错误不暴露给用户，只进日志
补充健康检查与自动告警线索
日志本身是被动记录，但可为监控埋点：
- 在日志中固定格式输出关键词，如
[DB_DOWN]或[AUTH_FAILED]，供日志采集器（Filebeat + ELK）提取指标 - 当连续 5 分钟出现 >10 条连接异常，触发企业微信/钉钉机器人告警（通过脚本定时扫描最新日志片段）
- 在部署后或配置变更后，主动执行一次
SELECT 1并记录成功日志，作为“连接正常”的基线标记
不复杂但容易忽略：日志路径要有写权限、磁盘别满、内容别含敏感凭证——这三件事做完，90% 的连接问题都能当天闭环。
