Laravel自定义验证消息不生效问题求助及原因排查

问题根源 #

你看到的The attachment failed to upload.并非max/file/mimes这些验证规则触发的错误，而是文件上传阶段的底层系统错误——这类错误发生在Laravel执行你定义的验证规则之前，所以你的自定义规则消息根本不会被触发。

常见的底层上传错误场景：

• 文件大小超出php.ini中upload_max_filesize或post_max_size的限制
• 服务器临时上传目录（upload_tmp_dir）无写入权限
• 文件上传过程中被中断、截断，或不是合法的上传文件

自定义上传错误消息的方法 #

要覆盖这类底层上传错误的默认消息，需要在消息数组中添加attachment.uploaded对应的配置：

$messages = array(
     'attachment.max' => 'max error',
     'attachment.file' => 'file error',
     'attachment.mimes' => 'mimes error',
     'attachment.uploaded' => '文件上传失败，请检查文件大小或服务器配置', // 新增该行
     //'attachment' => 'all errors',
);

验证规则生效的前提 #

只有当文件成功上传到服务器临时目录后，Laravel才会执行你定义的max/file/mimes规则，此时对应的自定义消息才会正常触发。比如：

• 文件大小在php.ini限制内，但超过max:1000，会返回你设置的max error
• 提交的内容不是合法文件，会返回file error
• 文件类型不符合mimes规则，会返回mimes error

排查建议 #

1. 检查php.ini关键配置：
   • upload_max_filesize：需大于你设置的max:1000（1000KB=1MB，所以该值至少≥1M）
   • post_max_size：必须大于upload_max_filesize
   • upload_tmp_dir：确认目录存在且服务器进程有写入权限
2. 确认表单已设置enctype="multipart/form-data"，否则无法完成文件上传
3. 用一个符合所有条件的小文件测试，验证你的自定义规则消息是否正常生效

内容的提问来源于stack exchange，提问作者José Victor