Yii2 AJAX表单验证需返回字段名→错误数组的JSON结构并设422状态码；控制器调用validate()后用getErrors()返回，配合Response::FORMAT_JSON；ActiveForm会自动解析该格式。
Yii2 中使用 ActiveRecord 配合 AJAX 进行表单验证时，核心在于让控制器返回符合前端（如 jQuery Validation 或 Yii 自带的 yii.activeForm）预期的 JSON 格式响应。关键不是“返回任意 JSON”，而是返回 字段名 → 错误信息数组 的结构，并配合正确的 HTTP 状态码。
后端控制器中正确返回验证错误 JSON
在控制器动作（Action）中，需手动触发模型验证，并将错误按字段组织为关联数组：
- 调用
$model->validate()主动触发验证（不会自动保存） - 用
$model->getErrors()获取字段级错误（返回形如['username' => ['用户名已存在'], 'email' => ['邮箱格式不正确']]的数组） - 使用
Yii::$app->response->format = Response::FORMAT_JSON确保响应为 JSON - 若验证失败，返回错误数组；若通过，可返回空数组或
['success' => true]
示例代码（在控制器 action 中）：
use yii\web\Response;
public function actionValidate()
{
$model = new User();
$model->load(Yii::$app->request->post(), '');
if ($model->validate()) {
\Yii::$app->response->format = Response::FORMAT_JSON;
return ['success' => true];
} else {
\Yii::$app->response->format = Response::FORMAT_JSON;
return $model->errors; // 直接返回 getErrors() 结果
}
}
前端 AJAX 请求匹配 Yii activeForm 默认行为
如果使用 Yii 内置的 ActiveForm（开启 enableAjaxValidation），无需手写 AJAX —— 表单会自动在失去焦点或提交时发请求到 validationUrl（默认为当前 action 加 ?ajax=xxx）。此时后端必须支持该约定：
- 检查请求是否为 AJAX 验证：
Yii::$app->request->isAjax && Yii::$app->request->get('ajax') - 提取验证字段：
Yii::$app->request->post('User')（假设 Model 类名为 User） - 验证后直接
return $model->errors即可，ActiveForm 会自动解析并显示
注意 HTTP 状态码与 Content-Type
Yii2 默认在 JSON 响应中设置 Content-Type: application/json，但状态码很重要：
- 验证失败时建议返回
422 Unprocessable Entity（语义更准确），可通过\Yii::$app->response->setStatusCode(422) - 验证通过时保持
200 OK - 避免返回
500或400除非真有服务端异常 —— 否则 ActiveForm 可能误判为网络错误而不处理 errors
调试技巧：快速确认返回结构
在浏览器开发者工具 Network 标签中查看响应体，合法的验证失败响应应类似：
{
"username": ["用户名长度不能少于 3 个字符"],
"email": ["邮箱格式不正确"]
}
若返回 {"success":true} 或空对象 {}，前端通常认为验证通过；若返回 {"error":"xxx"} 这类非字段结构，ActiveForm 将无法定位错误位置。
