yii2异步远程唯一性校验需三要素协同：模型保留unique规则、视图启用enableajaxvalidation、控制器响应ajax请求并返回json格式验证结果，缺一不可。
Yii2 中实现异步远程唯一性校验（如用户名、手机号是否已存在），核心是结合 unique 验证器 + AJAX 表单提交 + 客户端启用异步验证。它不是单纯“自定义验证器”，而是标准验证器的异步化使用，但需前后端协同配置。
启用异步验证的三要素
缺一不可，否则表单只做同步校验或完全不触发：
-
模型规则中保留
'unique'声明：它提供服务端校验逻辑和错误提示，是异步请求的后端依据
示例：['mobile', 'unique', 'targetClass' => User::class, 'message' => '该手机号已被注册'] -
视图中开启
enableAjaxValidation：
在ActiveForm::begin()或具体字段中设置：= $form->field($model, 'mobile', ['enableAjaxValidation' => true]) ?> -
控制器响应 AJAX 验证请求：必须拦截
isAjax && isPost请求，并调用ActiveForm::validate()
示例代码：
{
if (Yii::$app->request->isAjax && Yii::$app->request->isPost) {
Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
$model = new User();
if ($model->load(Yii::$app->request->post())) {
return \yii\widgets\ActiveForm::validate($model);
}
}
// ... 正常渲染逻辑
}
让 unique 校验更精准（避免全表扫描）
默认 unique 只查字段值，实际业务常需加条件（如“仅检查状态为启用的用户”）。用 filter 参数即可：
['email', 'unique', 'targetClass' => User::class, 'filter' => ['status' => User::STATUS_ACTIVE]]-
filter接收数组，等效于 AR 查询的where条件，支持嵌套：'filter' => ['and', ['status' => 1], ['type' => 'normal']]
自定义唯一性校验（绕过 unique，手动写逻辑）
当需要跨表、复合条件、或校验逻辑无法用 filter 表达时，可改用内联验证器 + 异步支持：
- 在
rules()中写内联规则，同时声明'on' => 'create'场景（可选）：['mobile', function ($model, $attribute, $params) {<br> $exists = User::find()->where(['mobile' => $model->$attribute, 'status' => 1])->exists();<br> if ($exists) {<br> $model->addError($attribute, '该手机号已被启用');<br> }<br>}, 'on' => 'create'] - 仍需控制器返回 JSON，视图开启
enableAjaxValidation—— 异步机制与unique完全一致，只是后端逻辑换成了你写的查询
常见失效原因与修复
异步校验“没反应”或“报 400/500 错误”，通常卡在这几个点：
- 控制器未设置
Yii::$app->response->format = Response::FORMAT_JSON→ 返回 HTML 导致 JS 解析失败 - 模型
load()失败（如场景不对、属性未声明safe）→validate()不执行任何规则 - 前端字段 name 属性与模型属性名不一致（如用了
name="User[mobile]"但模型是UserForm）→ 后端收不到数据 - CSRF 验证拦截：AJAX 提交需携带
X-CSRF-Token头，或在控制器中临时关闭（不推荐）：Yii::$app->controller->enableCsrfValidation = false;
