Laravel自定义Request验证JSON MIME类型失效问题排查

这个问题的核心在于JSON文件的MIME类型检测逻辑和Postman上传时的Content-Type设置，具体拆解如下：

为什么添加mimetypes:application/json会报错？ #

1. 文件实际MIME类型的识别偏差
   Laravel的mimetypes规则依赖PHP的finfo扩展检测文件内容类型，但很多简单的JSON文件（比如你上传的{ "name":"test" }）会被识别为text/plain而非application/json——因为JSON本质是纯文本格式，内容较短时finfo很容易判定为普通文本。

2. Postman上传时的Content-Type默认值
   在Postman的form-data中上传文件时，默认不会自动为JSON文件设置application/json的Content-Type，而是使用系统默认类型（比如text/plain或application/octet-stream），这也会触发Laravel的mimetypes验证失败。

可行的解决方案 #

方案1：改用mimes:json规则（推荐） #

mimes:json规则是检查文件扩展名是否为.json，这在绝大多数业务场景下已经足够，还能避开文件内容识别的偏差。修改你的rules方法：

public function rules() { 
    return [ 
        'name' => 'required|string|min:2|max:32|unique:game_templates', 
        'path' => 'required|string|url|unique:game_templates', 
        'settings' => 'required|file|mimes:json', // 替换为mimes:json
        'orientation' => Rule::in(GameTemplate::$orientations), 
    ]; 
}

方案2：手动设置Postman的文件Content-Type #

如果一定要保留mimetypes:application/json规则，可在Postman中手动指定文件的Content-Type：

• 在form-data区域找到settings对应的文件项
• 点击右侧的Content-Type下拉框，选择application/json
• 重新发送请求即可通过验证

方案3：自定义验证规则（进阶） #

如果需要同时验证文件内容是合法JSON且扩展名正确，可以自定义规则：

// 在AppServiceProvider的boot方法中注册规则
Validator::extend('valid_json_file', function ($attribute, $value, $parameters, $validator) {
    // 检查扩展名
    if (!in_array($value->getClientOriginalExtension(), ['json'])) {
        return false;
    }
    // 检查内容是否为合法JSON
    $content = file_get_contents($value->getPathname());
    return json_decode($content) !== null;
});

之后在rules中使用：

'settings' => 'required|file|valid_json_file',

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