Yii2 AJAX表单验证失败时需返回结构化JSON：设置422状态码，统一格式为{"success":false,"errors":{"field":["msg"]}}，可扁平化或嵌套，配合前端精准渲染错误。
Yii2 表单验证失败时，默认返回 HTML 页面或重定向，但在 AJAX 提交场景下，需要统一返回结构化的 JSON 错误信息，尤其是多字段错误需清晰对应字段名与错误消息。关键在于拦截验证失败流程，将 Model::getErrors() 转为扁平化或嵌套式 JSON，并保持 HTTP 状态码语义正确（如 422 Unprocessable Entity）。
手动捕获验证并返回结构化 JSON
在控制器动作中显式调用 $model->validate()，避免自动跳转。验证失败时，构造符合前端预期的响应格式：
- 使用
yii\web\Response::setStatusCode(422)标识语义化错误 - 调用
$model->getErrors()获取关联数组：['username' => ['用户名已存在'], 'email' => ['邮箱格式不正确']] - 可选择扁平化输出（适合简单表单）：
['username' => '用户名已存在', 'email' => '邮箱格式不正确']；或保留数组（支持多条错误）：['username' => ['用户名已存在'], 'email' => ['邮箱格式不正确']] - 统一包裹在
'success' => false和'errors'字段中，便于前端统一处理
全局统一 JSON 错误响应（推荐）
通过配置 beforeAction 或自定义基类控制器，对所有 AJAX 请求自动处理验证失败：
- 判断请求是否为 AJAX：
Yii::$app->request->isAjax - 监听
ModelEvent::EVENT_BEFORE_VALIDATE不够直接，更稳妥的是在控制器中统一拦截if (!$model->validate()) - 封装通用响应方法：
return $this->asJson(['success' => false, 'errors' => $model->getErrors()]); - 配合行为（Behavior）可进一步解耦，例如注册一个
JsonValidationBehavior自动扫描 action 返回值中的 Model 实例
前端接收与渲染多字段错误
后端返回的 JSON 需要前端能按字段名精准定位并显示错误提示：
- 假设返回：
{"success":false,"errors":{"username":["用户名不能为空"],"email":["邮箱格式错误"]}} - JS 中遍历
response.errors，用字段名查找对应 input 元素（如name="username"或data-field="username"） - 为每个字段插入或更新
<div class="help-block error">xxx</div>，避免重复添加 - 清空成功状态样式（如
.has-success），添加.has-error类
补充：AJAX 表单提交 + Yii2 ActiveForm 集成技巧
若使用 ActiveForm::begin(['enableAjaxValidation' => true])，需额外注意：
- 开启
enableAjaxValidation后，Yii 会自动发送独立验证请求，但默认返回 HTML 片段；需在控制器中单独处理该请求（检查Yii::$app->request->isAjax && Yii::$app->request->isPost） - 对应 action 中需调用
ActiveForm::validate($model)并直接return $this->asJson(ActiveForm::validate($model)) - 该方法返回格式固定：
[["field", "error message"], ...]，前端需适配解析逻辑
