Laravel项目图片上传后为0字节的问题求助

问题描述 #

Laravel控制器中编写的图片上传函数能成功生成图片文件，但文件大小为0字节，访问时提示加载出错，原代码如下：

public function upload(Request $request)
{
    $imageData = $request->input('imgBase64');
    $imageData = str_replace('data:image/png;base64,', '', $imageData);
    $imageData = str_replace(' ', '+', $imageData);
    $imageData = base64_decode($imageData);

    $imageName = time() . '.png';
    $path = public_path() . '/photos/' . $imageName;
    file_put_contents($path, $imageData);
    
    return response()->json([
        'success' => true,
        'message' => 'Image saved successfully.',
        'image_name' => $imageName
    ]);
}

排查与修复步骤 #

1. 校验Base64解码结果 #

base64_decode失败时会返回false，直接写入会生成0字节文件。添加解码校验逻辑：

$imageData = base64_decode($imageData, true); // 第二个参数设为true，解码失败返回false
if ($imageData === false) {
    return response()->json([
        'success' => false,
        'message' => '图片数据解码失败'
    ], 400);
}

2. 兼容多种图片格式前缀 #

原代码仅移除data:image/png;base64,前缀，若前端传递jpeg等其他格式图片，会导致前缀残留引发解码失败。改用正则匹配移除所有base64前缀：

$imageData = preg_replace('#^data:image/[^;]+;base64,#', '', $imageData);

3. 确保目标目录存在且权限合规 #

如果public/photos目录不存在，file_put_contents会生成空文件。添加目录检查与创建逻辑：

$dir = public_path('/photos');
if (!file_exists($dir)) {
    mkdir($dir, 0755, true); // 递归创建目录并设置合理权限
}

4. 验证前端传入数据完整性 #

临时添加日志打印，确认前端是否传递了完整的base64数据：

use Illuminate\Support\Facades\Log;

// 临时调试用，验证数据长度
Log::info('接收的base64数据长度: ' . strlen($request->input('imgBase64')));

优化后的完整代码 #

use Illuminate\Support\Facades\Log;

public function upload(Request $request)
{
    $imageData = $request->input('imgBase64');
    if (empty($imageData)) {
        return response()->json([
            'success' => false,
            'message' => '未接收到图片数据'
        ], 400);
    }

    // 移除任意格式的base64前缀
    $imageData = preg_replace('#^data:image/[^;]+;base64,#', '', $imageData);
    // 替换空格为+（处理URL编码导致的空格问题）
    $imageData = str_replace(' ', '+', $imageData);
    // 解码并校验结果
    $imageData = base64_decode($imageData, true);
    if ($imageData === false) {
        Log::error('Base64解码失败，原始数据片段: ' . substr($request->input('imgBase64'), 0, 100));
        return response()->json([
            'success' => false,
            'message' => '图片数据解码失败'
        ], 400);
    }

    // 确保存储目录存在
    $dir = public_path('/photos');
    if (!file_exists($dir)) {
        mkdir($dir, 0755, true);
    }

    $imageName = time() . '.png';
    $path = $dir . '/' . $imageName;
    
    // 写入文件并校验结果
    $writeResult = file_put_contents($path, $imageData);
    if ($writeResult === false) {
        return response()->json([
            'success' => false,
            'message' => '图片写入失败'
        ], 500);
    }

    return response()->json([
        'success' => true,
        'message' => '图片保存成功',
        'image_name' => $imageName
    ]);
}

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