
当将 php 布尔值(true/false)直接绑定到 mysql 的 tinyint(1) 字段时,不同数据库环境(如 mariadb 与 mysql)可能因 sql 模式和类型转换策略差异而表现不一致,导致 “incorrect integer value: ''” 错误;解决方法是显式转换为整数 0 或 1。
当将 php 布尔值(true/false)直接绑定到 mysql 的 tinyint(1) 字段时,不同数据库环境(如 mariadb 与 mysql)可能因 sql 模式和类型转换策略差异而表现不一致,导致 “incorrect integer value: ''” 错误;解决方法是显式转换为整数 0 或 1。
在使用 PDO(如 Laravel Query Builder、Doctrine DBAL 或原生 PDO)向 MySQL 类型为 TINYINT(1) 的布尔字段(如 is_escalated)写入数据时,看似简单的 false 或 true 值可能在某些环境中意外失败。例如:
$connection->update('requests', ['is_escalated' => false], ['id' => $id]);这段代码在本地 MariaDB 10.4 上可正常运行,但在 Azure Database for MySQL 5.7 上却抛出:
PDOException: SQLSTATE[HY000]: General error: 1366 Incorrect integer value: '' for column 'is_escalated'
根本原因在于:PDO 默认不会自动将 PHP 布尔值映射为整数 0/1;它可能以字符串形式 ' '、'' 或 NULL 传递,而严格模式下的 MySQL(尤其是启用了 STRICT_TRANS_TABLES 的 Azure MySQL)拒绝将空字符串隐式转为整数。
虽然 TINYINT(1) 常被用作布尔逻辑存储,但其本质仍是整数类型——MySQL 不原生支持布尔类型(BOOLEAN 是 TINYINT(1) 的同义词)。因此,必须确保传入的是明确的整数值:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
✅ 正确做法(推荐):
// 显式强制类型转换,语义清晰且跨环境兼容
$connection->update('requests', [
'is_escalated' => (int) $shouldEscalate // $shouldEscalate 是 bool
], ['id' => $id]);
// 或直接使用整数字面量
$connection->update('requests', [
'is_escalated' => $isActive ? 1 : 0
], ['id' => $id]);⚠️ 注意事项:
- 避免依赖
filter_var($bool, FILTER_VALIDATE_BOOLEAN)或(bool)双重转换,这无法解决底层参数绑定问题; - 不要使用字符串
'0'/'1'—— 若字段定义为TINYINT UNSIGNED(如题中tinyint(1) unsigned),字符串可能触发隐式转换失败或截断警告; - 在 Laravel Eloquent 中,可通过
$casts = ['is_escalated' => 'boolean']+ 访问器/修改器保障一致性;但底层仍需确保save()时属性值为整数(Eloquent 默认已处理,但自定义查询需手动干预); - 检查数据库 SQL 模式:
SELECT @@sql_mode;。若含STRICT_TRANS_TABLES或STRICT_ALL_TABLES(Azure MySQL 默认启用),则对非法类型输入更敏感。
? 总结:PHP 布尔值不是数据库整数的“安全默认映射”。为保证跨环境健壮性,始终将布尔逻辑显式转为 (int) 再写入 TINYINT 字段——这是零成本、高确定性的最佳实践。

















