Laravel更新操作时图片字段必填验证报错处理及旧值回填方案

问题根源 #

浏览器出于安全限制，禁止为type="file"类型的表单字段预设本地文件路径，因此你更新表单提交时，如果没有重新选择图片，file_upload字段会是空值，和你写的required验证规则冲突，才会抛出必填错误。不需要每次更新都重新上传图片，可以通过以下方案解决：

第一步：修改表单，新增旧文件存储字段 #

在你的表单里额外加一个隐藏域，存储已上传的旧文件名：

<div class="col-md-6 fv-row form-group" id="file_upload">
    <!-- 新增隐藏域存储旧文件名 -->
    <input type="hidden" name="old_file_upload" value="{{ $setting->file_name ?? '' }}">
    <label class="fs-6 fw-bold mb-2" for="file">
        File Upload
    </label>
    <input type="file" name="file_upload" onchange="loadPreview(this);" class="form-control form-control-solid @error('file_upload') is-invalid @enderror"
        id="file_upload"  value="" />
    <div class="kt_preview_image_container">
        <img id="kt_preview_img" src="{{asset('uploads/settings/'.$setting->file_name)}}" class="img-fluid"/>
        <a href="!#" class="kt_preview_image_close"><i class="fas fa-times"></i></a>
    </div>
    @error('file_upload')
    <span class="invalid-feedback" role="alert">
        <strong>{{ $message }}</strong>
    </span>
    @enderror
</div>

第二步：调整验证规则 #

把原来的必填规则改成「仅当旧文件不存在时才要求上传新文件」，Laravel验证规则写法如下：

'file_upload' => [
    'required_without:old_file_upload', // 没有旧文件时才要求必填（对应新增场景）
    'nullable', // 有旧文件时可以为空（对应更新不换图的场景）
    'image',
    'mimes:jpeg,png,jpg,svg',
    'max:2048'
],
// 可选补充：对旧文件字段加简单校验，避免非法提交
'old_file_upload' => 'nullable|string'

第三步：修改控制器保存逻辑 #

更新数据的时候判断是否上传了新文件，如果有就用新文件的存储路径，没有就直接用旧的文件名存入数据库即可：

// 示例逻辑，可根据你的实际业务调整
$validated = $request->validated();
if ($request->hasFile('file_upload')) {
    // 此处写你自己的新文件上传处理逻辑，得到新文件名$newFileName
    $validated['file_name'] = $newFileName;
} else {
    // 没有上传新文件，直接复用旧值
    $validated['file_name'] = $request->input('old_file_upload');
}
// 执行更新操作
Setting::where('id', $yourRecordId)->update($validated);

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