ActiveForm AJAX提交需四者链路对齐：表单配置enableAjaxValidation与validationUrl、控制器isAjax+load+FORMAT_JSON响应、JS初始化时机正确、错误JSON结构合规，缺一即失效。
ActiveForm 的 AJAX 提交不是开个开关就能跑通的，关键在链路对齐：表单配置、控制器响应格式、JS 初始化时机、错误结构约定，四者缺一不可。错一个环节，就会出现“点提交就刷新”“验证没反应”“返回 JSON 但标红不消失”这类问题。
enableAjaxValidation=true 为什么没触发后端请求
默认只做客户端校验（HTML5 或 Yii 自带 JS 规则），根本不会发请求到服务端。必须显式配 validationUrl，否则 Yii 会 fallback 到 site/validate-form，大概率 404。
-
validationUrl必须是可访问的真实路由，推荐用Url::to(['controller/action'])生成，避免硬编码路径 - 控制器里必须同时满足三个条件：请求是 AJAX（
Yii::$app->request->isAjax）、成功加载数据（$model->load(Yii::$app->request->post())）、响应格式设为 JSON（Yii::$app->response->format = Response::FORMAT_JSON） - 字段名要和模型属性严格一致；多模型场景下（如
User和Profile），需带前缀，例如'User[email]'，否则前端找不到对应 input
ajaxSubmit() 调用后页面跳转或无响应
不是 JS 写错了，而是初始化时机或拦截逻辑断了。常见于 DOM 还没 ready 就调用了方法，或被 Pjax 拦截。
- 不要在
$(function(){})里直接调$('#form-id').yiiActiveForm('submit')，应等 ActiveForm 初始化完成：$(document).on('afterInit', '#form-id', function() { ... }) - 如果页面用了
Pjax，表单必须加data-pjax="0"，否则点击按钮会被 Pjax 拦截并整页重载 - Network 面板看到请求发出去但返回的是完整 HTML → 控制器漏写了
Response::FORMAT_JSON，JS 解析失败后自动 fallback 到原生 submit - 控制台报
Uncaught TypeError: Cannot read property 'settings' of undefined→ 表单 DOM 实例未注册，多半是 ID 不匹配或ActiveForm::begin()的id参数和 JS 里选中的不一致
服务器验证返回的 JSON 格式必须严格合规
Yii 前端只认特定结构，随便 return 个数组会静默失败。
- 顶层必须是关联数组，key 是字段名（如
'email'），value 是字符串数组（如['邮箱已被占用']），不能是字符串或null - 某字段无错误，必须完全省略该 key；写成
'email' => []会被前端当成“有空错误”，input 持续标红 - 返回空对象
{}表示全部通过；全局错误（如 CSRF 失败）可用{"_token": ["Token 不合法"]} - 涉及嵌套属性（如
address[city]），key 必须和 input 的name属性完全一致，包括中括号
怎么防重复提交又不破坏验证状态
用户连点提交按钮时，多个 ajaxSubmit 并发发出，后端返回顺序不确定，UI 容易错乱。
- 按钮点击后立刻禁用：
$btn.prop('disabled', true)，且只在success和error回调里统一恢复，不要依赖beforeValidate这类中间钩子 - 避免手写
$.ajax()提交表单 —— 它绕过了 ActiveForm 的验证状态管理；优先用$('#form-id').yiiActiveForm('submit')，它会自动检查当前是否有 pending 验证 - 若必须手动 AJAX（比如传 FormData），记得先调
$('#form-id').yiiActiveForm('validate')并等其 Promise resolve 后再发提交请求
最常被忽略的是验证返回 JSON 的空字段处理和初始化时机 —— 这两个点不卡住，其他都好调；一旦卡住，排查方向很容易跑偏到 JS 语法或路由配置上。
