在 Laravel 8 中使用 Laravel Collective 表单组件上传图片时，若验证提示 “cover_image must be an image”，根本原因是表单未正确启用文件上传支持——必须显式设置 'files' => true，而仅添加 enctype="multipart/form-data" 不足以让 Laravel Collective 正确解析文件字段。

在 laravel 8 中使用 laravel collective 表单组件上传图片时，若验证提示 “cover_image must be an image”，根本原因是表单未正确启用文件上传支持——必须显式设置 `'files' => true`，而仅添加 `enctype="multipart/form-data"` 不足以让 laravel collective 正确解析文件字段。

Laravel 自带的表单构造器（如 @csrf + 原生

）会自动处理 enctype，但 Laravel Collective 的 Form::open() 方法需额外声明 'files' => true 才能启用文件上传支持。该选项不仅设置 enctype="multipart/form-data"，还会为请求对象正确绑定上传文件（$request->file('cover_image')），否则即使 HTML 层面存在 enctype，Laravel 也无法识别上传的文件，导致 image 验证规则始终失败。

✅ 正确的表单打开方式如下（关键修改已加注释）：

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

{!! Form::open([
    'action' => [App\Http\Controllers\PostController::class, 'store'],
    'method' => 'POST',
    'files'  => true // ← 必须添加此项！不可省略
]) !!}
    {{ Form::label('title', 'Title') }}
    {{ Form::text('title', '', ['class' => 'form-control', 'placeholder' => 'Title']) }}

    {{ Form::label('body', 'Body') }}
    {{ Form::textarea('body', '', ['class' => 'form-control', 'id' => 'article-ckeditor', 'placeholder' => 'Body text']) }}

    <div class="form-group">
        {{ Form::label('cover_image', 'Cover Image') }}
        {{ Form::file('cover_image', ['class' => 'form-control-file']) }}
    </div>

    {{ Form::submit('Submit', ['class' => 'btn btn-primary']) }}
{!! Form::close() !!}

⚠️ 注意事项：

• 'files' => true 是 Laravel Collective 特有的配置项，与原生 HTML 的 enctype 属性不同，它驱动底层表单构建逻辑，缺一不可；
• 路由应保持 Route::resource('/post', PostController::class) 不变，无需额外调整；
• 控制器中 validate() 规则 ['image', 'nullable', 'max:19999'] 是合理的，但前提是文件已成功传入——若 'files' => true 缺失，$request->file('cover_image') 将为 null，image 规则自然校验失败；
• 若后续需保存文件，建议使用 Laravel 内置的 store() 或 storeAs() 方法，并确保 storage/app/public 已软链接至 public/storage（运行 php artisan storage:link）。

总结：Laravel Collective 表单上传图片的核心前提，是 Form::open() 中明确指定 'files' => true。这是框架集成层的关键开关，而非单纯的 HTML 属性配置。忽略此配置，所有文件验证和处理逻辑都将失效。