Laravel 默认提交未勾选的 checkbox 不发送任何值，而勾选时仅发送字符串 "on"，导致 boolean 验证规则失败；本文提供两种可靠解决方式：显式设置 checkbox 的 value 值 + 使用 accepted 验证规则。
laravel 默认提交未勾选的 checkbox 不发送任何值，而勾选时仅发送字符串 "on"，导致 `boolean` 验证规则失败；本文提供两种可靠解决方式：显式设置 checkbox 的 value 值 + 使用 `accepted` 验证规则。
在 Laravel 9 中使用 Blade 模板渲染复选框（<input type="checkbox">）时，若后端采用 required|boolean 规则验证该字段，常会遇到如下错误：
The calculator field must be true or false.
这是因为 HTML 表单对 checkbox 的原生行为决定的：未勾选时，该字段根本不会出现在 POST 请求数据中；勾选时，浏览器默认提交字符串 "on"（而非布尔值或数字）。而 Laravel 的 boolean 验证规则仅接受以下值并自动转换为布尔类型：true、false、1、0、"1"、"0"、"true"、"false"、"on"（⚠️注意："on" 实际上 不被 boolean 规则认可 —— 这是常见误区）。
✅ 解决方案一：为 checkbox 显式指定 value 属性
修改 Blade 模板中的 checkbox，添加 value="1"（或其他你期望的真值）：
<input
type="checkbox"
class="form-control"
name="calculator"
id="calculator"
value="1"
>
<label for="calculator">Calculator</label>此时：
- 勾选 → 提交
calculator=1 - 未勾选 → 不提交
calculator字段（即请求中无此键）
配合服务端验证规则：
$request->validate([
'calculator' => 'required|boolean' // ✅ 现在能正确识别 "1" 为 true
]);? 提示：
required|boolean在此场景下语义稍有偏差（因未勾选时不提交，required会直接失败），更推荐搭配nullable|boolean或改用accepted（见下文）。
✅ 解决方案二：使用 accepted 验证规则（推荐）
Laravel 内置的 accepted 规则专为表单确认类字段设计，明确支持 yes、on、1、true 四种字符串形式，并要求字段必须存在且为其中之一（即隐含 required）：
$request->validate([
'calculator' => 'accepted' // ✅ 自动兼容 "on"，且强制勾选才通过
]);对应模板无需修改（保留默认 value="on" 行为）：
<input type="checkbox" name="calculator" id="calculator"> <label for="calculator">Calculator</label>
✅ 优势：语义清晰（表示“用户已接受/启用”）、开箱即用、无需干预前端值、符合 UX 直觉。
⚠️ 注意事项与最佳实践
不要依赖
isset($request->calculator)判断：因未勾选时字段不存在，应使用$request->has('calculator')或直接交由验证层处理；若需区分“启用/禁用”双状态（如开关），建议使用
<select></select>或两个 radio 按钮，而非 checkbox；-
Blade 中可结合
old()辅助函数实现提交失败后的状态保持：<input type="checkbox" name="calculator" value="1" {{ old('calculator') ? 'checked' : '' }} > 最终验证逻辑应与业务语义对齐：
accepted适用于“同意条款”“启用功能”等非空承诺场景；boolean更适合接收明确布尔参数的 API 接口。
通过以上任一方式，即可彻底解决 Laravel 中 checkbox 因 "on" 值导致的 boolean 验证失败问题，确保表单健壮性与开发体验。
