当pdo数据库连接未成功建立时，`$this->db` 为 `false`，直接调用 `prepare()` 会触发“call to a member function prepare() on boolean”致命错误。本文详解原因、诊断方法及健壮性修复方案。
该错误（Call to a member function prepare() on boolean）并非语法问题，而是典型的运行时逻辑缺陷：$this->db 实际值为 false，说明 PDO 实例初始化失败，但代码仍假设其为有效对象并调用 prepare() 方法。
根本原因通常有以下几种：
- 数据库连接参数错误（如主机名、端口、用户名、密码、数据库名不正确）；
- PDO 扩展未启用（php.ini 中 extension=php_pdo_mysql.dll 等未开启）；
- MySQL 服务未运行或拒绝连接；
- 构造 PDO 实例时未设置异常模式（PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION），导致连接失败静默返回 false 而非抛出异常。
✅ 正确的 PDO 初始化示例（含错误处理）
try {
$dsn = "mysql:host=localhost;dbname=your_db;charset=utf8mb4";
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
];
$this->db = new PDO($dsn, $username, $password, $options);
} catch (PDOException $e) {
error_log("PDO Connection failed: " . $e->getMessage());
throw new RuntimeException("Database connection unavailable", 500);
}✅ 安全调用 prepare() 的防护写法
在执行 $this->db->prepare($sql) 前，必须确保 $this->db 是有效的 PDO 对象：
if (!$this->db instanceof PDO) {
throw new RuntimeException('Database connection is not established.');
}
$sth = $this->db->prepare($sql); // ✅ 此时可安全调用⚠️ 注意：不要用 if (!$this->db) 粗略判断——因为 PDO 实例可能为 null 或 false，而 instanceof PDO 是最准确的类型断言方式。
? 补充建议：重构 query() 方法增强鲁棒性
将原 query() 方法开头补充连接校验与自动重连逻辑（如需）：
立即学习“PHP免费学习笔记（深入）”；
public function query($sql, $args_to_prepare = []) {
if (!$this->db instanceof PDO) {
$this->connect(); // 触发重连（需实现 connect() 方法）
if (!$this->db instanceof PDO) {
throw new RuntimeException('Failed to establish database connection.');
}
}
$sth = $this->db->prepare($sql);
// 绑定参数（推荐使用 bindParam 或 execute 数组，而非正则替换）
if (!empty($args_to_prepare)) {
foreach ($args_to_prepare as $name => $val) {
$paramName = ':' . $name;
$sth->bindValue($paramName, $val, is_int($val) ? PDO::PARAM_INT : PDO::PARAM_STR);
}
}
$sth->execute();
return $sth;
}✅ 关键改进点总结：
- 使用 PDO::ERRMODE_EXCEPTION 让连接/查询失败立即暴露；
- 用 instanceof PDO 替代布尔判断，避免误判；
- 避免 preg_replace 拼接 SQL（存在 SQL 注入风险且破坏预处理语义）；
- 使用 bindValue() 或 execute($params) 进行安全参数绑定；
- 将数据库连接逻辑封装为独立、可复用、可测试的方法（如 connect()），而非散落在各处。
遵循以上实践，即可彻底规避该错误，并显著提升数据库层的稳定性与安全性。
