Laravel：验证规则构造函数自动注入实现及失败原因排查

先给你划个重点：Laravel不会自动帮你手动实例化的规则类注入依赖，必须让服务容器来创建规则类的实例，才能触发自动注入。下面是几种靠谱的实现方式：

1. 在表单请求里直接用规则类的类名字符串 #

如果你用的是Form Request做验证，直接把规则类的类名（字符串形式）丢进规则数组就行，Laravel会自动通过容器解析它，顺便把构造函数里的依赖注入进去：

// 比如你的表单请求类
public function rules()
{
    return [
        'email' => ['required', 'email', UniqueEmailRule::class],
    ];
}

这种方式最省心，也是官方推荐的用法。

2. 用服务容器解析规则类 #

如果是在控制器里写验证逻辑，别自己new MyRule()，而是用app()辅助函数让容器帮你实例化：

$rules = [
    'user_id' => [app(CheckUserExistsRule::class)],
];

$this->validate($request, $rules);

容器会自动识别规则类构造函数里的依赖，帮你注入进去。

3. 自定义绑定（特殊场景用） #

如果你的规则类需要一些自定义的解析逻辑，比如要传一些固定参数，也可以在AppServiceProvider的register方法里手动绑定：

public function register()
{
    $this->app->bind(MyCustomRule::class, function ($app) {
        // 这里可以自定义实例化逻辑，比如注入特定的依赖实例
        return new MyCustomRule($app->make(UserRepository::class), 'some-fixed-value');
    });
}

不过大部分时候用前两种方法就够了，这个属于进阶操作。

我猜你大概率踩了下面某一个坑：

• 手动new了规则类：如果你写的是new MyRule()，那完全是你自己创建的实例，Laravel容器根本没参与，自然没法帮你注入依赖。必须让容器来创建实例，要么用类名字符串，要么用app()。
• 依赖是接口但没绑定实现：如果你的规则类构造函数里注入的是接口（比如UserRepositoryInterface），Laravel不知道该给你传哪个实现类，必须在服务提供者里绑定接口到具体实现：

  // 在AppServiceProvider里加这个
  $this->app->bind(UserRepositoryInterface::class, UserRepository::class);
  

• 构造函数有基本类型参数：如果你的构造函数里有int、string这种基本类型的参数，容器没法自动知道你要传什么值（总不能猜吧？）。这种情况要么手动传参，要么改成用setter方法来设置：

  // 不好的写法：容器无法解析$max的值
  public function __construct(int $max) {}
  
  // 改成这样
  public function setMax(int $max): self {
      $this->max = $max;
      return $this;
  }
  
  // 使用时
  $rules = [
      'field' => [app(MyRule::class)->setMax(10)],
  ];
  

• 规则类命名空间错了：如果你的规则类不在正确的命名空间下（比如应该在App\Rules里却放错了地方），Laravel找不到这个类，容器自然没法解析，会报类不存在的错误。

给你举个完整的正确示例：

比如我们做一个检查用户是否存在的规则，需要注入User模型：

// App/Rules/CheckUserExists.php
namespace App\Rules;

use App\Models\User;
use Illuminate\Contracts\Validation\Rule;

class CheckUserExists implements Rule
{
    protected $userModel;

    // 构造函数注入User模型
    public function __construct(User $userModel)
    {
        $this->userModel = $userModel;
    }

    public function passes($attribute, $value)
    {
        return $this->userModel->where('id', $value)->exists();
    }

    public function message()
    {
        return '选中的用户不存在哦';
    }
}

在表单请求里正确使用：

// App/Http/Requests/AssignUserRequest.php
namespace App\Http\Requests;

use App\Rules\CheckUserExists;
use Illuminate\Foundation\Http\FormRequest;

class AssignUserRequest extends FormRequest
{
    public function rules()
    {
        // 正确写法：用类名字符串，Laravel自动注入依赖
        return [
            'user_id' => ['required', CheckUserExists::class],
            // 错误写法：手动new，不会注入
            // 'user_id' => ['required', new CheckUserExists()],
        ];
    }
}

内容的提问来源于stack exchange，提问作者Philipp Mochine