Laravel文件上传max验证消息异常：返回uploaded消息而非自定义内容

在Laravel中实现文件上传时，使用max规则限制文件大小，却未触发自定义的image.max验证消息，反而返回了uploaded规则对应的提示：图片上传失败。但uploaded规则的作用是校验文件是否上传失败，并非用于文件大小校验。

代码示例 #

public function rules()
{
    return [
        'image' => 'required|max:2048|file|mimetypes:image/jpg,image/jpeg,image/png'
    ];
}

public function messages()
{
    return [
        'image.max' => '图片文件大小不能超过2Mb.'
    ];
}

预期结果 #

图片文件大小不能超过2Mb.

实际结果 #

图片上传失败.

问题原因与解决方案 #

原因 #

这是因为PHP配置（php.ini）中的上传限制值小于你在Laravel中设置的max规则值，导致文件在到达Laravel验证逻辑之前就被PHP拦截，Laravel无法执行max规则校验，只能识别为上传失败，返回uploaded对应的错误。

解决步骤 #

1. 修改php.ini配置：
   找到并调整以下两个参数，确保值大于你设置的2048KB（2MB）：
   • upload_max_filesize：建议设置为4M或更大
   • post_max_size：该值需大于upload_max_filesize，比如设置为5M
2. 重启服务：修改配置后，重启你的Web服务器（Apache/Nginx）和PHP服务，使配置生效
3. 优化验证规则顺序：建议将规则调整为required|file|mimetypes:image/jpg,image/jpeg,image/png|max:2048，先校验文件类型再校验大小，逻辑更清晰

内容的提问来源于stack exchange，提问作者Blues Clues