Laravel API 数据验证：正确处理嵌套 JSON 字段的完整指南-php教程-PHP中文网

Laravel API 数据验证：正确处理嵌套 JSON 字段的完整指南

laravel 的 validate() 方法不支持直接在规则数组中嵌套子数组来校验 json 对象字段，必须使用点号（dot）语法声明嵌套路径，否则会触发 badmethodcallexception。

laravel 的 validate() 方法不支持直接在规则数组中嵌套子数组来校验 json 对象字段，必须使用点号（dot）语法声明嵌套路径，否则会触发 badmethodcallexception。

在构建 Laravel API 时，对客户端提交的嵌套 JSON 数据（如 motor 对象）进行验证是常见需求。但需特别注意：Laravel 的验证器 不接受规则数组中嵌套关联数组 的写法——这正是你遇到 BadMethodCallException: Method Illuminate\Validation\Validator::validateRequired|string does not exist 错误的根本原因。

该异常并非由拼写错误或数据格式引发，而是因为 Laravel 解析验证规则时，将 'motor' => ['type' => 'required|string'] 这类结构误认为是在调用一个名为 validateRequired|string 的不存在验证方法（它尝试把整个字符串 'required|string' 当作方法名解析）。

✅ 正确做法是：统一使用点号（.）语法显式声明嵌套字段路径。例如，motor.type、motor.hp 等，而非将 motor 作为键嵌套一个规则子数组。

以下是修正后的完整验证代码：

chartjs-reporter

此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。

下载

$request->validate([
    'model' => 'required|string',
    'brand' => 'required|string',
    'year' => 'required|integer|min:1980|max:' . (date('Y') + 1),
    'price' => 'required|numeric|min:0',
    'color' => 'required|string',
    'traction' => 'required|string|in:2x2,4x2,4x4',
    'motor.type' => 'required|string|in:gasoline,diesel,hybrid,electric',
    'motor.hp' => 'required|integer|min:0',
    'motor.turbo' => 'required|boolean',
    'motor.cylinders' => 'required|integer|min:3|max:16',
    'motor.motor_liters' => 'required|numeric|min:0.5|max:8.5',
    'user_id' => 'required|integer|exists:users,id',
]);

? 关键注意事项：

✅ 所有嵌套字段（如 motor.type）必须与请求 JSON 中的实际结构完全匹配（区分大小写，且 motor_liters 在 JSON 中为驼峰，规则中也须保持一致）；
⚠️ 不要添加额外空格（如 'motor. type' 会导致验证失效）；
✅ 支持链式规则（如 in:gasoline,diesel）、存在性检查（exists:users,id）及范围约束（min/max），增强健壮性；
? 若需对整个嵌套对象做存在性校验（如确保 motor 对象非空），可补充 'motor' => 'required|array' 规则；
? 建议配合 Laravel 的 validated() 方法获取清洗后数据：$data = $request->validated();，其中 motor 将自动按结构提取为关联数组。