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