Laravel中如何获取验证错误？unique规则误判问题排查

一、查看Laravel捕获的验证错误 #

有两种实用方式：

• 前端/Blade模板中查看：Laravel会自动将验证错误存入session，在Blade模板里可直接遍历输出：

  @if ($errors->any())
      <div class="alert alert-danger">
          <ul>
              @foreach ($errors->all() as $error)
                  <li>{{ $error }}</li>
              @endforeach
          </ul>
      </div>
  @endif
  

• 后端手动捕获错误：放弃$request->validate()的自动跳转/响应逻辑，改用Validator facade手动校验，直接打印错误详情：

  use Illuminate\Support\Facades\Validator;
  
  $validator = Validator::make($request->all(), [
      'email' => 'required|email|unique:users',
      'password' => 'nullable|min:6',
      'name' => 'nullable|string|max:255',
      'about_me' => 'nullable|string|max:300',
  ]);
  
  if ($validator->fails()) {
      // 打印所有错误信息
      dd($validator->errors()->all());
      // 若为API请求，返回JSON格式错误
      // return response()->json(['errors' => $validator->errors()], 422);
  }
  
  // 校验通过后获取合法数据
  $validatedData = $validator->validated();
  

二、邮箱唯一性误判的常见原因及解决 #

1. 邮箱格式不一致
   输入的邮箱可能包含前后空格，或与数据库中邮箱存在大小写差异（比如数据库存Admin@test.com，提交admin@test.com）。解决方法：在验证规则中添加trim和lowercase规则，统一格式后再校验：

   'email' => 'required|email|trim|lowercase|unique:users',
   

2. 软删除记录干扰
   如果User模型使用了软删除（引入use SoftDeletes;），默认的unique规则会包含已软删除的用户。需修改规则排除软删除数据：

   'email' => 'required|email|unique:users,email,NULL,id,deleted_at,NULL',
   

3. 数据库索引异常
   检查users表的email字段是否存在唯一索引，若索引损坏或未创建，会导致校验逻辑异常。可通过数据库工具查看索引，或执行SQL重建：

   ALTER TABLE users ADD UNIQUE INDEX unique_email (email);
   

4. 数据库环境不匹配
   确认当前应用连接的数据库是预期环境（避免连接到测试库/备用库），防止因目标数据库存在重复邮箱导致误判。

5. 验证规则缓存残留
   若之前修改过验证规则，可能存在缓存残留。执行以下命令清除缓存：

   php artisan config:clear
   php artisan cache:clear
   

内容的提问来源于stack exchange，提问作者The Outstanding Question Asker