Laravel 8 接收AJAX提交的base64图片保存时报500错误如何解决

核心错误点 #

• 未定义变量错误：代码中将文件保存结果赋值给了$fileName变量，但后续判断时错误使用了完全不存在的$imageName变量，PHP运行时会直接抛出未定义变量异常，这是触发500错误的最直接原因。
• base64解码结果无校验：base64_decode($image)如果解码失败会返回布尔值false，直接调用storeAs方法会触发「调用非对象的成员函数」错误。
• 请求参数无校验逻辑：未校验$request->images是否存在、数组内每个元素是否存在src字段、base64格式是否合法，当传入参数不符合预期时，substr、explode、strpos等字符串操作会抛出索引不存在、参数无效等异常。
• 存储配置/权限异常：如果配置的my_uploaded_files磁盘对应本地目录没有读写权限、磁盘配置未在config/filesystems.php中定义，执行storeAs写入文件时会抛出IO异常。
• 文件名重复风险：循环内使用time()生成文件名，当循环执行速度快于1秒时，time()返回相同时间戳，可能导致文件名重复覆盖，该问题不会直接触发500错误，但会影响业务逻辑正确性。

修复后参考代码 #

public function add_ref_images_first(Request $request){
    // 先校验必填参数
    $request->validate([
        'images' => 'required|array',
        'images.*.src' => 'required|string'
    ]);
    
    $end_url = "";
    $count = 0;
    $folder_name = 'PUBP' . time();
    foreach ($request->images as $data){
        $image_64 = $data['src'];
        // 校验base64格式合法性
        if(!str_contains($image_64, ';base64,')){
            continue;
        }
        // 提取扩展名
        $extension = explode('/', explode(':', substr($image_64, 0, strpos($image_64, ';')))[1])[1];
        $replace = substr($image_64, 0, strpos($image_64, ',')+1);
        $image = str_replace($replace, '', $image_64);
        $image = str_replace(' ', '+', $image);
        // 解码base64并校验结果
        $image_content = base64_decode($image);
        if(!$image_content){
            continue;
        }
        // 用随机数替代time避免重复
        $ref_image_id = 'PUBR'.uniqid().$count++.'.'.$extension;
        // 存储文件
        $fileName = \Illuminate\Http\File::useContents($image_content)->storeAs($folder_name, $ref_image_id , ['disk' => 'my_uploaded_files']);
        // 修复变量名错误
        if($fileName){
            $end_url .= $fileName.',';
        }
    }
    // 去掉末尾多余的逗号
    $end_url = rtrim($end_url, ',');
    return response()->json(['url' => $end_url, 'id' => '1']);
}

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