yii2模型验证错误信息支持多语言需三步：配置i18n组件并确保翻译文件路径正确；rules()中所有message用yii::t()调用且占位符自动替换；避免内置验证器绕过翻译，需显式覆盖message并同步客户端提示，动态切换语言后须清i18n缓存。
在Yii2中让模型验证错误信息支持多语言，必须让验证器返回的提示文本走i18n翻译流程，而不是硬编码字符串。这要求验证规则中的message参数全部替换为Yii::t()调用，且category与翻译文件严格对应。
配置i18n组件并确保基础翻译可用
打开config/web.php或config/main.php，在components数组中添加或确认已存在i18n配置：
‘i18n’ => [‘translations’ => [‘app’ => [‘class’ => ‘yii\i18n\PhpMessageSource’, ‘basePath’ => ‘@app/messages’, ‘fileMap’ => [‘app’ => ‘app.php’]]]],
【basePath指向的@app/messages目录必须真实存在，且包含zh-CN/、en-US/等子目录】。若目录缺失，Yii::t()将始终返回原字符串，验证提示无法翻译。
在@app/messages/zh-CN/app.php中写入： ‘用户名不能为空。’, ‘Email is not a valid email address.’ => ‘邮箱格式不正确。’];
重写模型rules()，用Yii::t()包裹所有message值
在Model类的rules()方法中，禁止直接写死中文或英文提示。每个验证规则的message选项必须调用Yii::t()：
public function rules()
{
return [
[[‘username’], ‘required’, ‘message’ => Yii::t(‘app’, ‘Username cannot be blank.’)],
[[‘email’], ‘email’, ‘message’ => Yii::t(‘app’, ‘Email is not a valid email address.’)],
[[‘password’], ‘string’, ‘min’ => 8, ‘message’ => Yii::t(‘app’, ‘Password must be at least {n} characters.’, [‘n’ => 8])],
];
}
注意第三个规则用了占位符{n}，这是Yii2原生支持的格式化方式，无需额外处理。只要翻译文件里对应键是‘Password must be at least {n} characters.’ => ‘密码长度不能少于{n}位。’，变量就会自动替换。
避免内置验证器绕过翻译的陷阱
方法一：禁用验证器默认message，强制走自定义message
Yii2部分验证器（如unique、exist）会优先使用自身内置的message模板，即使你写了‘message’ => Yii::t(...)，也可能被忽略。解决办法是显式覆盖其内部属性：
[[‘email’], ‘unique’, ‘targetClass’ => User::class, ‘message’ => Yii::t(‘app’, ‘This email has already been taken.’), ‘on’ => ‘create’]
方法二：用客户端验证兜底时同步更新提示
若启用了ActiveForm客户端验证，需同时配置clientOptions.message，否则前端弹出的仍是英文提示。例如：
‘clientOptions’ => [‘validateOnSubmit’ => true, ‘messages’ => [‘email’ => Yii::t(‘app’, ‘Email is not a valid email address.’)]]
这一步容易遗漏，导致前后端提示语言不一致。
动态切换语言后立即生效验证提示
第一步：在控制器init()或行为中提前设置语言
public function init()
{
parent::init();
$lang = Yii::$app->request->get(‘lang’, ‘zh-CN’);
if (in_array($lang, [‘zh-CN’, ‘en-US’, ‘ja-JP’])) {
Yii::$app->language = $lang;
}
}
第二步：清除runtime缓存
修改了@app/messages/zh-CN/app.php后，必须删除runtime/cache/下的i18n*缓存文件，否则新翻译不会加载。这一步不可跳过，否则调试时永远看到旧提示。
第三步：验证模型前确保语言已设定
不要在视图里才调Yii::$app->language = ‘en-US’；必须在Controller::actionXXX()开头或beforeAction()中完成，否则Model::validate()执行时仍用默认语言。
