Laravel Backpack+Docker环境JPG上传报错：Unable to init from given binary data

问题现象 #

• 上传JPEG/JPG图片时触发错误：Unable to init from given binary data
• PNG图片可正常上传，相同代码在同版本PHP的标准AWS部署服务器上运行正常，仅Docker环境存在该问题

报错位置 #

报错发生在以下代码行：

$thumbMini = Image::make(env('AWS_S3_URL')  .$imageUid)->fit(56,56)->stream();

业务代码 #

{
    // 1. 生成文件名
    $filename = Carbon::now()->format('Y-m-d-His').'.jpg';

    // 2. 存储图片到磁盘
    $imageUid = $destination_path.'/'.$filename;

    list($type, $imageData) = explode(';', $value);
    list($type, $imageData) = explode(',', $value);
    $imageData = base64_decode($imageData);

    Storage::disk($disk)->put($imageUid, $imageData);

    // 3. 保存路径到数据库
    $this->attributes[$attribute_name] = $destination_path.'/'.$filename;

    $thumbImageName = '/thumb-'.basename($imageUid);
    $thumbMiniImageName = '/thumb-mini-'.basename($imageUid);
    $path = 'uploads/user/image/'.$this->uuid;

    $thumbMini = Image::make(env('AWS_S3_URL')  .$imageUid)->fit(56,56)->stream();
    $thumb = Image::make(env('AWS_S3_URL')  .$imageUid)->fit(140,140)->stream();

    Storage::disk('s3')->put($path.$thumbImageName,$thumb->__toString());
    Storage::disk('s3')->put($path.$thumbMiniImageName,$thumbMini->__toString());

    $this->attributes['thumb_uid'] = $path.$thumbImageName;
    $this->attributes['thumb_mini_uid'] = $path.$thumbMiniImageName;
}

示例图片数据 #

"image_uid": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQANq7/Z",

Docker PHP扩展配置 #

RUN apt update && apt install -y supervisor wget git openssh-server unzip postgresql-client libfreetype6-dev libjpeg62-turbo-dev libpq-dev libzip-dev libpng-dev libonig-dev libxml2-dev libcurl4-openssl-dev libssl-dev libjpeg-dev curl cron --no-install-recommends \
        && docker-php-ext-install sockets zip opcache pdo_pgsql mbstring exif gd && docker-php-ext-configure pdo_pgsql --with-pdo-pgsql=/usr/ && docker-php-ext-configure gd --with-freetype=/usr/include/ --with-jpeg=/usr/include/

环境版本 #

• PHP 8.2.7
• Laravel 10.44.0

可能的解决方案 #

1. 验证GD扩展的JPEG支持 #

进入Docker容器执行以下命令，确认JPEG支持已启用：

php -i | grep -i jpeg

若输出无JPEG Support => enabled，调整Dockerfile的GD配置：

• 确保libjpeg62-turbo-dev安装成功
• 将docker-php-ext-configure gd的参数简化为--with-freetype --with-jpeg，让系统自动依赖路径

2. 直接使用本地二进制数据生成缩略图 #

避免从S3拉取图片的额外步骤，直接用解码后的二进制数据生成缩略图，修改代码如下：

// 替换原缩略图生成逻辑
$originalImage = Image::make($imageData);

$thumbMini = $originalImage->clone()->fit(56,56)->stream();
$thumb = $originalImage->clone()->fit(140,140)->stream();

3. 检查图片数据完整性 #

将base64_decode后的$imageData写入临时文件，验证格式是否有效：

# 在容器内执行
echo "$imageData" > /tmp/test.jpg
file /tmp/test.jpg

若输出不是JPEG image data，排查前端上传的base64字符串是否存在传输截断。

4. 更新Intervention Image库 #

确保使用的图片处理库版本兼容当前Laravel版本，执行更新：

composer update intervention/image

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