Laravel 10自定义规则报错：$fail参数应为Closure却传入数组

问题根源分析 #

你遇到的两个核心问题：

1. 参数类型错误：validate()方法第3个参数$fail被传入数组而非Closure，这是因为规则类的方法签名不符合Laravel 10的ValidationRule接口规范。
2. 验证始终报错：去掉类型声明后规则可执行但验证失效，大概率是验证逻辑写反，或未正确调用$fail闭包。

另外需要明确：Laravel 10已废弃可调用规则（invokable rules），必须使用实现ValidationRule接口的规则类。

修复步骤 #

1. 确保规则类结构正确 #

重新生成规则类（若之前的类被修改坏了）：

php artisan rule:make ValidPackageItem

生成的类默认会实现ValidationRule接口，正确的方法签名如下：

namespace App\Rules;

use Closure;
use Illuminate\Contracts\Validation\ValidationRule;

class ValidPackageItem implements ValidationRule
{
    /**
     * 执行验证逻辑
     *
     * @param  \Closure(string): \Illuminate\Translation\PotentiallyTranslatedString  $fail
     */
    public function validate(string $attribute, mixed $value, Closure $fail): void
    {
        // 在这里编写你的验证逻辑，验证失败时调用$fail()
        if (!$this->checkValidity($value)) {
            $fail('The :attribute is not a valid package item.');
        }
    }

    // 自定义验证逻辑方法
    private function checkValidity(mixed $value): bool
    {
        // 示例：验证是否为数组，且包含有效id和正整数数量
        if (!is_array($value)) {
            return false;
        }

        return isset($value['id'], $value['quantity']) 
            && is_numeric($value['quantity']) 
            && $value['quantity'] > 0;
    }
}

2. 修正控制器中的规则调用 #

在控制器/表单请求中正确引用规则，无需额外参数传递（若需传参，通过构造函数实现）：

use App\Rules\ValidPackageItem;

// 控制器方法内的验证逻辑
public function store(Request $request)
{
    $validated = $request->validate([
        // 单个商品验证
        'package_item' => ['required', new ValidPackageItem],
        // 数组批量验证（每个元素都要符合规则）
        'package_items.*' => ['required', new ValidPackageItem],
    ]);

    // 后续业务逻辑
}

3. 解决验证始终报错问题 #

验证失效通常是逻辑反转导致的，需注意：

• 验证通过时，无需任何操作；
• 验证失败时，才调用$fail()闭包传入错误信息。

比如错误逻辑：

// 错误：只要是数组就触发报错
if (is_array($value)) {
    $fail('The :attribute must be an array.');
}

正确逻辑：

// 正确：不是数组才触发报错
if (!is_array($value)) {
    $fail('The :attribute must be an array.');
}

4. 带参数的自定义规则（可选） #

若规则需要动态参数（比如允许的商品类型），通过构造函数传递：

class ValidPackageItem implements ValidationRule
{
    private $allowedTypes;

    public function __construct(array $allowedTypes)
    {
        $this->allowedTypes = $allowedTypes;
    }

    public function validate(string $attribute, mixed $value, Closure $fail): void
    {
        if (!in_array($value['type'], $this->allowedTypes)) {
            $fail('The :attribute type is not allowed.');
        }
    }
}

调用时传入参数：

'package_item' => ['required', new ValidPackageItem(['physical', 'digital'])],

内容的提问来源于stack exchange，提问作者Ahmed Wagih Refaey