Yii2 ActiveForm 的 AJAX 提交本质是禁用页面跳转并手动处理响应，需配置 enableAjaxValidation、正确绑定 JS、控制器显式调用 load() 和 save()，模态框中必须用 renderAjax()，字段名前缀须严格匹配 formName()。
Yii2 中 ActiveForm 的 ajax 提交本质是“禁用页面跳转 + 手动接管响应”
它不是 magic，而是把原本由浏览器自动完成的表单提交（同步、刷新）换成 JS 主动发起请求（异步、不刷新），再根据返回结果决定下一步动作。关键点在于：ActiveForm::begin() 配置必须启用 ajax 支持，否则 beforeSubmit 事件根本不会触发，$.ajax 也拿不到表单数据结构。
常见错误现象：
- 点击提交后页面直接跳转（说明
enableAjaxValidation或 JS 绑定没生效） - 控制台报错
Uncaught TypeError: Cannot read property 'length' of undefined（通常因表单 ID 不匹配或未正确注册 JS） - 验证通过但数据库没更新（控制器里漏了
$model->load($post)或事务未提交）
actionSave() 必须显式调用 load() 和 save()，不能只靠 validate()
很多人误以为开启 enableAjaxValidation 就能自动保存，其实它只负责校验字段规则（如 required、email 格式），不执行任何持久化逻辑。真正写库必须在控制器中手动处理。
实操建议：
- 用
$request->post()获取完整数据，而非硬编码字段名 - 先
$model->load($post)再$model->validate()，顺序不能反（否则空模型无法触发规则） - 若需更新已有记录，确保 URL 带主键参数（如
['save', 'id' => $model->id]），并在控制器中用findOne()加载实例 - 失败时返回 JSON 结构（如
['success' => false, 'errors' => $model->getErrors()]），前端才能统一提示
模态框场景下，renderAjax() 是必须项，否则 JS 无法绑定
如果表单在 modal 弹窗里，控制器返回 $this->render('create') 会导致整个页面 HTML 被塞进 modal，破坏 DOM 结构，$('#form-id') 找不到目标元素，JS 事件全部失效。
正确做法：
- 控制器动作返回
$this->renderAjax('create', ['model' => $model]) - 视图中
ActiveForm::begin()必须设'id' => 'my-form'，且与 JS 中选择器一致 - JS 注册要放在视图末尾或用
$this->registerJs()，避免 DOM 未就绪 - 注意：模态框本身需有
data-backdrop="static"防止点击空白关闭，干扰提交流程
跨模型更新时，load() 的字段前缀必须严格匹配命名约定
比如同时更新 User 和 Profile，POST 数据必须是 ['User[username]' => 'a', 'Profile[nickname]' => 'b'] 格式，否则 $user->load($post) 和 $profile->load($post) 都会静默失败。
容易踩的坑：
- 视图里用
$form->field($user, 'username')渲染，但没传$user->formName()到ActiveForm::begin()的'id'，导致字段名变成默认user-username而非User[username] - 手动拼接 input name（如
<input name="User[username]">）却忘了在控制器中调用$user->formName()做校验，load()不识别 - 使用
updateAll()批量更新时绕过了模型层，但遗漏了beforeSave钩子或时间戳自动填充逻辑
最常被忽略的一点：ajax 提交成功后，$model->save() 返回 true 只代表 ActiveRecord 层写入成功，不代表事务已提交——如果用了 beginTransaction() 却没 commit()，数据仍会回滚。别假设框架会替你兜底。
