PHP数据库连接错误处理关键在于启用异常模式：PDO推荐设置PDO::ATTR_ERRMODE为PDO::ERRMODE_EXCEPTION；mysqli需用mysqli_report()开启严格模式或手动检查错误，配合网络、权限、服务、PHP层诊断及重试降级策略确保可靠。
PHP 连接数据库时，错误处理不是“有没有”的问题，而是“怎么用才可靠”的问题。默认情况下，很多数据库扩展（如 mysqli 或 PDO）并不会自动抛出异常，容易让连接失败静默发生，导致后续逻辑崩溃却找不到原因。
启用异常模式（推荐 PDO）
PDO 支持通过设置 PDO::ATTR_ERRMODE 属性开启异常驱动的错误处理，让所有错误（包括连接失败、查询语法错、约束冲突等）都以 PDOException 形式抛出，便于统一捕获：
- 连接时传入选项：
new PDO($dsn, $user, $pass, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]) - 一旦连接失败（如密码错误、服务未启动、DNS 不可达），立即抛出异常，不会返回 false
- 配合
try...catch可精准区分连接层、SQL 层、业务层错误
mysqli 的两种模式要分清
mysqli 提供面向对象和过程两种接口，错误处理方式不同：
- 面向对象方式下，默认不抛异常，需手动调用
$mysqli->connect_error或$mysqli->error检查；也可用mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT)开启异常模式（需在 new mysqli 前调用） - 过程式写法（如
mysqli_connect()）失败直接返回false，必须显式判断并用mysqli_connect_error()获取原因 - 注意：
mysqli_report()是全局设置，影响后续所有 mysqli 操作，建议在初始化阶段集中配置
连接失败的常见原因与诊断建议
单纯报“Connection refused”或“Access denied”不够，应结合上下文快速定位：
立即学习“PHP免费学习笔记（深入）”；
- 网络层：检查 host 是否可 ping、端口（如 3306）是否开放（
telnet host 3306）、防火墙策略 - 权限层：确认用户是否有从当前 IP（或 %）登录的权限，且对应数据库存在（
GRANT ... ON db.* TO 'user'@'host'） - 服务层：确认 MySQL/MariaDB 进程运行中（
systemctl status mysql），max_connections 未耗尽，bind-address 配置允许外部连接 - PHP 层：确认
extension=mysqli.so或pdo_mysql.so已启用，且 PHP 版本与数据库协议兼容（如 MySQL 8 默认 use caching_sha2_password，旧版 PHP 可能不支持）
不要忽略重连与降级逻辑
生产环境中，单次连接失败不等于永久不可用。可在捕获异常后加入简单重试（带退避）或切换备用数据库实例：
- 避免无限重试，建议最多 2–3 次，间隔 100–500ms
- 若主库不可用，可尝试只读从库提供基础数据（需业务逻辑支持读写分离）
- 记录完整错误信息（含时间、IP、SQL、错误码），但不要直接输出给前端（防止敏感信息泄露）
- 对非关键操作（如日志写入、统计上报），可设计为“尽力而为”，连接失败时静默跳过
错误处理的关键不是掩盖问题，而是让失败可见、可追溯、可恢复。用好异常模式、分清错误层级、结合运维手段验证链路，连接问题就不再是个黑盒。
