Yii2 Ajax表单验证返回JSON的核心是启用ActiveForm的Ajax验证并配置专用action：设enableAjaxValidation为true、validationUrl指向仅处理Ajax请求且返回validate()结果的action，模型需定义unique等支持Ajax的rules。
Yii2 中 Ajax 表单验证返回 JSON，核心是让框架在验证失败时自动输出标准 JSON 格式响应，而不是 HTML 或重定向。关键不在“手动 echo JSON”，而在于正确启用验证机制、设置响应格式、并确保控制器和模型协同工作。
开启 ActiveForm 的 Ajax 验证支持
在视图中使用 ActiveForm::begin() 时，必须显式启用 Ajax 验证，并指定验证入口地址：
-
enableAjaxValidation 设为
true，否则不触发前端异步校验 -
validationUrl 指向一个专用的 controller action（如
site/validate），该 action 只负责接收 POST 数据并返回验证结果 - 不需要写额外 JS 监听，ActiveForm 内置逻辑会在用户离开字段或提交前自动发起验证请求
控制器中正确返回验证 JSON
对应 validationUrl 的 action 必须满足两个条件：判断是否为 Ajax 请求 + 主动设为 JSON 格式：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 用
Yii::$app->request->isAjax做前置校验，避免非 Ajax 场景误执行 - 立即设置
Yii::$app->response->format = \yii\web\Response::FORMAT_JSON - 调用
\yii\widgets\ActiveForm::validate($model)并直接 return 其返回值（它已是结构化数组，框架会自动 encode） - 不要在该 action 中调用
render、echo或var_dump，否则破坏 JSON 输出
模型 rules 要匹配唯一性等服务端规则
前端实时提示依赖后端验证逻辑，所以模型里必须定义可被 Ajax 触发的规则：
- 像
['email', 'unique']、['username', 'unique']这类规则，默认支持 Ajax 验证 - 自定义验证方法（如
validateEmailAvailable()）需加注释说明或确保其在load()后能被validate()调用到 - 确保
targetClass指向实际存储数据的模型类（例如User::class），否则查不到已有记录
避免常见 JSON 返回异常
即使代码写对，也常因环境配置出错导致前端收不到合法 JSON：
- 检查 Network 面板中验证请求的 Response Headers 是否含
Content-Type: application/json; charset=UTF-8 - 如果看到 HTML 内容混在 JSON 里，大概率是某处提前输出了空格、BOM 或调试语句（比如在 config/web.php 里写了
echo） - NGINX 开启 gzip 时，若 JSON 被截断（少一个
}），浏览器可能静默失败——此时看 Raw Response 最准 - 不要在
beforeAction()里全局设FORMAT_JSON，否则普通页面渲染也会变 JSON，引发乱码
