Yii2中AJAX表单提交需前后端协同：视图中设置enableAjaxValidation=>true、validationUrl；控制器中actionValidate绑定数据并调用$model->validate()，以Response::FORMAT_JSON返回['error'=>$model->getErrors()]或['success'=>true]；注意CSRF防护、场景设置及JSON纯净输出。
Yii2 中使用 AJAX 提交表单并触发服务端验证，返回 JSON 格式错误信息是常见需求。关键在于前后端配合：前端正确发送数据、处理响应；后端正确开启验证、统一输出 JSON 结构。
确保 ActiveForm 启用 AJAX 提交
在视图中使用 ActiveForm::begin() 时，设置 'enableAjaxValidation' => true 和 'validateOnSubmit' => true，并指定验证路由：
use yii\widgets\ActiveForm;
$form = ActiveForm::begin([
'id' => 'user-form',
'enableAjaxValidation' => true,
'enableClientValidation' => false, // 可选：禁用客户端验证，专注服务端
'validateOnSubmit' => true,
'validationUrl' => ['site/validate'], // 指向自定义验证动作
]);
注意：validationUrl 默认为当前控制器同名 action（如 actionCreate），但建议显式指定，便于调试和解耦。
后端 Action 返回标准 JSON 验证结果
在控制器中，需手动触发模型验证，并以 JSON 格式返回错误（或 success）。Yii2 的 $model->validate() 不会自动抛出异常，需自行判断：
- 调用
$model->load(Yii::$app->request->post())绑定数据 - 执行
$model->validate() - 若含错误，用
Yii::$app->response->format = Response::FORMAT_JSON并返回['error' => $model->getErrors()] - 若验证通过，可返回
['success' => true]或继续处理保存逻辑
示例（SiteController::actionValidate()）：
public function actionValidate()
{
$model = new User();
if (Yii::$app->request->isPost && $model->load(Yii::$app->request->post())) {
Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
return $model->validate()
? ['success' => true]
: ['error' => $model->getErrors()];
}
throw new BadRequestHttpException('Invalid request');
}
AJAX 响应调试技巧
浏览器开发者工具 Network 面板是核心调试入口：
- 筛选 XHR 请求，找到对应表单提交或验证请求
- 查看 Headers → Response → Preview，确认返回的是纯 JSON（无 HTML 混入）
- 若返回 500 错误，点开 Response 查看 Yii 错误堆栈（开发环境需开启
YII_DEBUG = true） - 检查 Console 是否报 JS 错误（如
Uncaught TypeError: Cannot read property 'replace' of undefined），常因后端未返回预期结构导致
小技巧：在控制器中临时加 Yii::info(['post' => $_POST, 'errors' => $model->getErrors()], 'validate');，再查 runtime/logs/app.log 快速定位数据绑定或规则问题。
避免常见陷阱
以下问题高频出现，直接影响 JSON 验证流程：
-
CSRF 验证失败：AJAX POST 必须携带
X-CSRF-Token头。可在视图中添加：<meta name="csrf-token" content="= Yii::$app->request->csrfToken ?>">，JS 中统一设置：$.ajaxSetup({ headers: { 'X-CSRF-Token': $('meta[name="csrf-token"]').attr('content') } }); -
模型场景（scenario）未设置：如
$model->scenario = 'create'，否则验证规则可能不生效 -
字段名不一致：表单字段 name 如
User[username]，需确保模型属性名匹配，且load()能正确映射 -
JSON 输出被其他内容污染：确保 action 中无
echo、var_dump或多余空格，否则 JSON 解析失败
