Laravel Excel导出含图片文件提示文件不存在问题求助

可能的原因与对应解决办法 #

1. 本地/生产环境路径差异与权限问题 #

• 生产环境不要直接使用本地的相对路径或asset()生成的URL，Laravel Excel导出图片时是读取本地文件系统，而非HTTP请求。改用Laravel提供的路径辅助函数生成绝对路径：

  // 生成服务器本地绝对路径
  $imageLocalPath = public_path('storage/images/xxx.jpg');
  

• 检查生产环境图片文件的权限，确保Web服务器用户（如www-data）拥有读取权限：

  chmod -R 644 storage/app/public/images/
  chown -R www-data:www-data storage/app/public/images/
  

2. 云存储图片的处理逻辑 #

如果图片存储在OSS、S3等云存储服务，不能直接用远程URL作为路径，需要先下载到服务器临时目录再读取：

// 示例：将云存储图片下载到本地临时目录
$tempPath = storage_path('temp/temp_image.jpg');
Storage::disk('s3')->download('remote/path/to/image.jpg', $tempPath);

// 使用临时路径导入图片
$drawing = new \PhpOffice\PhpSpreadsheet\Worksheet\Drawing();
$drawing->setPath($tempPath);

3. CSV格式的特殊性 #

CSV本身不支持嵌入图片，只能存储文本内容。导出时需区分格式处理：

public function map($item): array
{
    if ($this->getWriterType() === \Maatwebsite\Excel\Excel::CSV) {
        // CSV模式仅返回图片URL
        return [
            $item->title,
            asset('storage/images/' . $item->image)
        ];
    } else {
        // XLSX模式嵌入图片（需在sheet方法中单独处理单元格图片）
        return [
            $item->title,
            // 留空，后续通过Drawing类插入图片
        ];
    }
}

4. 正确使用Laravel Excel的图片嵌入方法 #

避免直接在单元格中写入<img>标签，改用官方推荐的Drawing类插入图片：

public function sheet($sheet)
{
    $drawing = new \PhpOffice\PhpSpreadsheet\Worksheet\Drawing();
    $drawing->setName('Item Image');
    $drawing->setPath(public_path('storage/images/xxx.jpg'));
    $drawing->setCoordinates('B2'); // 指定插入的单元格位置
    $drawing->setHeight(50); // 设置图片高度
    $drawing->setWorksheet($sheet);
}

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