Laravel 13 查询语句本身不执行类型转换，报错实际发生在模型层 $casts 或手动 cast 阶段；常见于布尔、枚举、整数字段与数据库值不兼容，需清洗脏数据或自定义 Cast 兜底。
Laravel 13 查询语句本身不执行 PHP 层的类型转换，报错通常发生在模型层（如 $casts）或手动 cast 操作时，与查询构建器（Query Builder）无关。所谓“查询语句强制类型转换报错”，实际是模型取值阶段触发了不兼容的类型映射，尤其集中在布尔、枚举、整数等字段上。
确认是不是模型 $casts 导致的
绝大多数“查询后报 Invalid boolean value”或 “Invalid enum value” 都不是查询语句的问题，而是模型读取结果时，$casts 尝试把数据库原始值转成 PHP 类型失败了。重点检查：
- 数据库字段是否为
TINYINT(1)，但存了2、-1或NULL—— MySQL 8.0.16+ 不再隐式兼容，Laravel 会直接抛Invalid boolean value - 字段在模型中声明为
'status' => 'boolean'，但数据库类型是VARCHAR或ENUM——$casts只对特定底层类型生效，其他类型会被忽略或报错 - 使用了 Laravel Enum cast，但数据库里存在已弃用的旧值（如
'bot'），而新代码没定义该枚举项
修复布尔字段类型不匹配
不要改 $casts 为 'integer' 来绕过错误——这会让 $user->active 返回 0/1 而非 true/false，破坏语义一致性。正确路径是：
- 先查脏数据：
SELECT status, COUNT(*) FROM users GROUP BY status;看是否有非0/1值 - 清洗数据：
UPDATE users SET status = CASE WHEN status != 0 THEN 1 ELSE 0 END; - 再运行迁移，显式改为布尔类型：
$table->boolean('status')->change();（Laravel 13 支持，自动加UNSIGNED NOT NULL） - 模型中保持
protected $casts = ['status' => 'boolean'];
处理枚举或自定义类型转换异常
如果报错来自枚举（如 App\Enums\UserRole::class），说明数据库值无法匹配当前枚举列表。不建议删数据或硬改代码，推荐用自定义 Cast 类兜底：
- 新建
app/Casts/UserRoleCast.php，实现CastsAttributes -
get()方法中用match或try/catch捕获无效值，返回默认枚举项或null - 模型中改用
castUsing(UserRoleCast::class)替代字符串写法 - 这样既保留类型安全，又避免因历史数据导致整个请求崩溃
排查是否误在查询中做了强制转换
极少数情况是开发者在 selectRaw、DB::raw 或 when 动态条件里写了类似 (bool) active 的 PHP 强转，而该字段尚未从数据库取出——这属于逻辑错误，应移除或延后到模型层处理。查询阶段只负责取原始数据，类型转换交给模型或服务层更清晰。
