activeform::validate() 返回键为字段名、值为错误信息数组的嵌套结构，如 ['username' => ['username cannot be blank.']]；服务端需用 object.keys(errors).length > 0 判断，客户端应使用 aftervalidate 的 errorattributes 参数检测错误字段。
ActiveForm::validate() 返回的错误数组结构是什么
调用 ActiveForm::validate($model)（服务端）或 $("#form").yiiActiveForm("validate", true)（客户端）后，返回值不是布尔值，而是一个嵌套数组：键为字段名，值为该字段的错误信息数组。例如：['username' => ['Username cannot be blank.'], 'email' => ['Email is not valid.'] ]。前端 JS 处理时若直接用 if (errors) 判断，会永远为真——因为非空数组在 JS 中是 truthy 值。
正确做法是检查是否有任意字段含错误：
- 服务端 JSON 响应中：用
if (Object.keys(errors).length > 0)或if (errors.username?.length || errors.email?.length) - 客户端 afterValidate 回调里：
errorAttributes参数才是字段名数组（如['username', 'email']），它比遍历整个messages更可靠
为什么 ActiveForm::begin() 后没显示任何错误提示
常见原因是表单未绑定模型，或模型字段名与视图中 $form->field($model, 'xxx') 的第二个参数不一致。ActiveForm 错误渲染依赖 $model->getErrors('xxx') 能取到对应字段的错误，否则 {error} 占位符为空。
- 确认控制器中传入视图的
$model是实例化后的对象（如new LoginForm()），不是空数组或 null - 检查 rules() 中定义的字段名是否和
field()第二个参数完全一致（大小写、下划线、复数等） - 若使用了
scenario，确保$model->scenario已设置，且 rules() 中该场景包含对应字段 -
ActiveForm::begin()必须配对ActiveForm::end()，否则 JS 初始化失败，{error}不会被替换
ajaxValidation = true 时验证码总报错
这是因为每次调用 ActiveForm::validate() 都会触发完整验证流程，包括重新生成验证码——导致用户刚输完的验证码立刻失效。Yii2 的验证码组件（Captcha）默认在验证通过后就销毁 session 中的验证码值。
- 解决方法：异步验证时排除验证码字段，只验证业务字段。例如：
ActiveForm::validate($model, ['username', 'password']) - 同时确保控制器 action 中不调用
$model->validate()全字段验证，否则验证码校验仍会执行 - 验证码字段的最终校验必须留给表单 submit 时的完整 POST 流程，不能在 ajaxValidation 阶段介入
客户端验证通过但提交后仍报错，错误不显示
这是 CSRF 和表单提交方式不匹配导致的典型现象：客户端验证成功，但表单提交时因 CSRF 失败被拦截，服务端跳转到 error 页面或返回空白，{error} 根本没机会渲染。
- 检查表单 HTML 源码中是否存在
<input type="hidden" name="_csrf" value="...">，且 value 不为空 - 若用 AJAX 提交，确认请求头
X-CSRF-Token的值来自<meta name="csrf-token" content="...">，而不是实时调用Yii::$app->request->csrfToken - 禁用客户端验证（
enableClientValidation => false）测试一次，看错误是否正常显示——能排除是否是 JS 干扰了错误渲染流程
help-block 或 has-error 类名，看对应字段容器里有没有生成 <div class="help-block">...</div>。没有，说明验证结果根本没传到视图层；有但内容为空，大概率是字段名不匹配或模型未绑定。
