自定义验证规则需手动绑定语言包，通过 __('validation.key') 动态调用翻译，确保 resources/lang/zh_CN/validation.php 正确定义键值，并在 Validator::extend() 后使用 Validator::replacer() 处理占位符。
怎么让自定义验证规则显示中文提示
自定义验证规则（比如 required_if_active 或 phone_zh）默认不会读取 resources/lang/zh_CN/validation.php 里的翻译，除非你主动把它和语言包绑定。Laravel 只对内置规则（如 required、email）自动走语言文件，自定义规则得手动“注册”提示。
- 在规则类的
message()方法里，**不能直接写中文字符串**，否则多语言切换时就失效了；要改用__('validation.phone_invalid')这种动态调用 - 确保
resources/lang/zh_CN/validation.php中已定义对应键，例如：'phone_invalid' => '手机号格式不正确' - 如果规则是通过
Validator::extend()在服务提供者中注册的，记得在boot()里调用Validator::replacer()处理占位符（如:attribute），否则字段名不会被替换
FormRequest 里 messages() 方法为啥没生效
写了 messages() 却还是英文？大概率是语言环境还没就位——表单请求实例化发生在中间件执行前，而 App::setLocale() 通常在中间件里调用，这时候 messages() 已经执行完了，__() 拿到的还是默认 locale。
- 别在
messages()里硬编码中文，也别依赖运行时 locale 切换；稳妥做法是把翻译键写死，靠语言包兜底，例如：'mobile.required' => __('validation.mobile_required') - 确认
config/app.php的'locale'和'fallback_locale'设置正确，且值与语言目录名完全一致（zh_CN≠zh-cn） - 清缓存：改完语言配置后必须运行
php artisan config:clear，否则旧配置仍生效
attributes 映射不生效的典型表现
错误提示里还显示 email、password 而不是“邮箱地址”“密码”？说明 attributes 数组没被正确加载或结构不对。
-
resources/lang/zh_CN/validation.php必须包含顶层'attributes'键，且是关联数组，不能嵌套在其他键下 - 字段名要和规则里的一致：如果验证规则写的是
'user_email'，那attributes里就得有'user_email' => '用户邮箱'，而不是只写'email' - Laravel 10+ 对数组结构更严格：不能漏掉
'min' => ['string' => '...']这类嵌套，否则整个文件可能被跳过
多语言错误响应里字段名还是英文
返回 JSON 时看到 "email": ["The email has already been taken."]，但期望是中文，甚至想同时返回中英文——这说明验证消息生成阶段没介入成功。
- 不要试图在
failedValidation()里重写 MessageBag，它接收的是已渲染好的消息，再转译容易出错且无法保留占位符参数 - 真正可控的入口是
messages()方法或验证器构造时传入的customMessages参数，这两处才能保证消息按当前 locale 渲染 - 若需并行输出多语言（如 en/fr），必须在规则定义阶段就预置所有语言的键，靠
__('key', [], 'fr')显式指定 locale，不能依赖全局设置
最常被忽略的一点：语言文件路径、目录名、配置项三者必须严丝合缝，差一个下划线或大小写，Laravel 就静默 fallback 到英文——它不会报错，只会让你反复怀疑是不是代码写错了。
