Laravel使用AJAX单文件上传出现Array to String conversion错误如何解决

错误原因&修复方案 #

1 核心错误点

• 表单文件字段命名错误：视图中文件上传框的name属性设为了file_name[]，带数组标记，即使只上传单个文件，后端收到的也是数组格式，直接操作或存入数据库就会触发数组转字符串报错。
• 数据写入逻辑顺序错误：在文件处理完成前就调用updateOrCreate方法，直接将未处理的文件对象/数组赋值给file_name字段存入数据库，是触发报错的直接原因。
• 文件操作语法错误：已经通过$file = $request->file('file_name')拿到了文件实例，后续调用方法不需要再次传字段名，$file('file_name')->xxx()的写法不符合语法规范。
• 验证规则缺失：file_name的验证规则没有加file限定，无法正确校验上传内容是否为合法文件；自定义错误提示没有绑定规则名，不会生效。
• updateOrCreate参数逻辑错误：第一个参数是查询匹配条件，第二个是要写入/更新的字段，全写在第一个参数里会导致匹配逻辑异常。

2 修复后的代码

视图部分（仅修改文件输入框）

把原有文件输入框代码替换为：

<input type="file" id="file_id" name="file_name" class="form-control">

去掉name属性后的数组括号[]即可。

控制器store方法

public function store(Request $request)
{
    $request->validate([
        'name' => 'required',
        'contact_number' => 'required|numeric',
        'email' => 'required', 
        'total_exp' => 'required|numeric',
        'skillsets' => 'required',
        'current_organization' => 'nullable',
        'remarks' => 'nullable',
        'file_name' => 'required|file|max:2048' // 补充file验证规则
    ],
    [   
        'name.required' => 'This field is mandatory',
        'contact_number.required' => 'This field is mandatory',
        'email.required' => 'This field is mandatory', 
        'total_exp.required' => 'This field is mandatory',
        'skillsets.required' => 'This field is mandatory',
        'total_exp.numeric' => 'Only numeric values allowed',
        'contact_number.numeric' => 'Only numeric values allowed'
    ]);

    // 第一步先处理上传文件
    $file = $request->file('file_name');
    $fname = rand() . '.' . $file->getClientOriginalName() . '.' . $file->getClientOriginalExtension();
    $file->move(public_path('documents'), $fname);

    // 第二步再写入数据库，传入处理后生成的文件名
    $career = CareerForm::updateOrCreate(
        // 查询条件：可根据需求调整，这里用邮箱作为唯一匹配标识
        ['email' => $request->email],
        // 要写入/更新的字段
        [
            'name'=>$request->name,
            'contact_number'=>$request->contact_number,
            'total_exp'=>$request->total_exp,
            'skillsets'=>$request->skillsets,
            'current_organization'=>$request->current_organization,
            'remarks'=>$request->remarks,
            'file_name' => $fname,
        ]
    );

    return response()->json([
        "success" => true,
    ]);
}

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