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 调用来看待。
