Precognition 是 Laravel 的服务端预验证机制，通过前置验证请求（带 Precognition: true 头）提前暴露错误，不减少 AJAX 请求量；需控制器调用 validate()、前端解析 X-Validation-Errors 响应头。

Precognition 是什么，它真能减少 AJAX 请求？

不能。Precognition 本身不是“减少请求”的技术，而是 Laravel 提供的一种服务端预验证机制，它要求前端在提交表单前，先用 Precognition 请求头发起一次 POST（或 PUT/PATCH）请求，让服务端提前运行验证逻辑——但不执行实际业务逻辑（比如不创建模型、不发邮件）。它增加了一次请求，换来的是更早暴露验证错误、避免无效提交、提升 UX 连贯性。

如何启用 Precognition 验证并返回正确响应？

Laravel 10.42+ 原生支持 Precognition，关键在于：控制器方法必须显式声明 ->validate() 或使用 validated()，且请求必须带 Precognition: true 头。Laravel 会自动拦截并只运行验证规则，跳过后续逻辑。

• 不加 Precognition: true 头 → 按普通请求处理（验证 + 执行业务）
• 加了但控制器没调用 validate() → 返回 405 或 500（取决于是否匹配路由）
• 加了且调用了 validate() → 返回 204（成功）或 422（验证失败），body 为空，错误信息在 X-Validation-Errors 响应头中（JSON 字符串）

public function store(Request $request)
{
    // ✅ 必须调用 validate() 或 validated()
    $validated = $request->validate([
    
    'email' => ['required', 'email', 'unique:users'],
        'password' => ['required', 'min:8'],
    ]);

    // ... 实际业务逻辑（仅在非 Precognition 请求中执行）
    User::create($validated);

    return response()->noContent();
}

前端怎么发 Precognition 请求并读取错误？

不能依赖浏览器原生表单提交，必须用 fetch 或 axios 手动构造请求，并主动解析 X-Validation-Errors 响应头。常见错误是直接读 response.json() —— 因为 Precognition 响应 body 是空的，会报错。

• 必须设置请求头：Precognition: true 和 Accept: application/json
• 必须检查响应状态码：422 表示验证失败，204 表示通过
• 错误信息在响应头里：response.headers.get('X-Validation-Errors')，需 JSON.parse() 后使用
• 不要在 catch 中统一处理所有错误 —— 网络失败和验证失败要区分

const response = await fetch('/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Precognition': 'true',
    'Accept': 'application/json',
  },
  body: JSON.stringify({ email: 'test@example.com', password: '123' }),
});

if (response.status === 422) {
  const errors = JSON.parse(response.headers.get('X-Validation-Errors'));
  // { "email": ["The email has already been taken."] }
  renderErrors(errors);
} else if (response.status === 204) {
  // 可以放心提交正式请求
}

为什么实时验证还是卡顿？几个容易忽略的点

Precognition 请求本身不慢，但体验卡顿往往来自误用或环境配置：

• 没配 APP_URL 或 HTTPS 代理，导致本地开发时跨域预检（OPTIONS）被阻塞
• 验证规则里用了 exists、unique 等查库规则 → 每次输入都触发 DB 查询，没加缓存或延迟防抖
• 前端在 input 事件里无节流地发请求 → 一秒打 10 次，后端排队，用户看到“上一条错误还没消失，新错误又来了”
• 没关掉 Laravel 的 VerifyCsrfToken 中间件对 Precognition 的拦截 —— 默认它会放行，但若自定义了中间件逻辑，可能误判

真正影响体验的，从来不是 Precognition 本身，而是你有没有把它当成一个需要节流、缓存、隔离网络异常的普通 API 调用来看待。