本地正常生产环境报Intervention Image无法解码临时文件错误

本地运行正常，但生产环境抛出以下异常：

Intervention\Image\Exception\NotReadableException: Unable to decode image from file (/tmp/GlideYgGwCS)

异常来自Intervention\Image\Gd\Decoder第82行，提示程序尝试读取临时目录中的文件，但实际文件已成功存储在服务器本地。

相关代码如下：

// 从API响应中存储文件到磁盘，已验证本地和生产环境存储正常
$disk = Storage::disk('local');

$date = now()->toDateString();

$fileName = str()->uuid();

// $response已验证可用
$disk->put($date.'/folder-name/'.$fileName.'.png', $response->getBody(), 'public');

// 后续执行代码
$path = Storage::disk('local')->path($date.'/folder-name/'.$fileName.'.png');

$post = Post::findOrFail(1);

// 此处抛出错误，使用Spatie Media Library包
$post->addMedia($path)
  ->preservingOriginal()
  ->toMediaCollection('photos');

已确认本地和生产环境中该PNG文件均正常存储，不确定是否需要更换Storage::disk('local')->path()的路径传递方式。

环境驱动信息 #

本地环境 #

GD Support => enabled
GD headers Version => 2.3.3
GD library Version => 2.3.3

生产环境 #

GD Support => enabled
GD headers Version => 2.3.3
GD library Version => 2.3.3
Imagick compiled with ImageMagick version => ImageMagick 6.9.10-23 Q16 x86_64 20190101 https://imagemagick.org
Imagick using ImageMagick library version => ImageMagick 6.9.10-23 Q16 x86_64 20190101 https://imagemagick.org
ImageMagick copyright => © 1999-2019 ImageMagick Studio LLC
ImageMagick release date => 20190101
ImageMagick number of supported formats:  => 235
ImageMagick supported formats => 3FR, 3G2, 3GP, AAI, AI, ART, ARW, AVI, AVS, BGR, BGRA, BGRO, BIE, BMP, BMP2, BMP3, BRF, CAL, CALS, CANVAS, CAPTION, CIN, CIP, CLIP, CMYK, CMYKA, CR2, CRW, CUR, CUT, DATA, DCM, DCR, DCX, DDS, DFONT, DJVU, DNG, DOT, DPX, DXT1, DXT5, EPDF, EPI, EPS, EPS2, EPS3, EPSF, EPSI, EPT, EPT2, EPT3, ERF, EXR, FAX, FILE, FITS, FRACTAL, FTP, FTS, G3, G4, GIF, GIF87, GRADIENT, GRAY, GRAYA, GROUP4, GV, H, HALD, HDR, HISTOGRAM, HRZ, HTM, HTML, HTTP, HTTPS, ICB, ICO, ICON, IIQ, INFO, INLINE, IPL, ISOBRL, ISOBRL6, JBG, JBIG, JNG, JNX, JPE, JPEG, JPG, JPS, JSON, K25, KDC, LABEL, M2V, M4V, MAC, MAGICK, MAP, MASK, MAT, MATTE, MEF, MIFF, MKV, MNG, MONO, MOV, MP4, MPC, MPEG, MPG, MRW, MSL, MSVG, MTV, MVG, NEF, NRW, NULL, ORF, OTB, OTF, PAL, PALM, PAM, PANGO, PATTERN, PBM, PCD, PCDS, PCL, PCT, PCX, PDB, PDF, PDFA, PEF, PES, PFA, PFB, PFM, PGM, PGX, PICON, PICT, PIX, PJPEG, PLASMA, PNG, PNG00, PNG24, PNG32, PNG48, PNG64, PNG8, PNM, PPM, PREVIEW, PS, PS2, PS3, PSB, PSD, PTIF, PWP, RADIAL-GRADIENT, RAF, RAS, RAW, RGB, RGBA, RGBO, RGF, RLA, RLE, RMF, RW2, SCR, SCT, SFW, SGI, SHTML, SIX, SIXEL, SPARSE-COLOR, SR2, SRF, STEGANO, SUN, SVG, SVGZ, TEXT, TGA, THUMBNAIL, TIFF, TIFF64, TILE, TIM, TTC, TTF, TXT, UBRL, UBRL6, UIL, UYVY, VDA, VICAR, VID, VIFF, VIPS, VST, WBMP, WEBP, WMF, WMV, WMZ, WPG, X, X3F, XBM, XC, XCF, XPM, XPS, XV, XWD, YCbCr, YCbCrA, YUV

1. 改用Spatie Media Library的磁盘直接读取方法 #

Spatie Media Library提供了addMediaFromDisk方法，无需手动拼接本地路径，直接通过Laravel Storage磁盘读取文件，避免路径解析问题：

$post->addMediaFromDisk($date.'/folder-name/'.$fileName.'.png', 'local')
    ->preservingOriginal()
    ->toMediaCollection('photos');

2. 验证文件权限 #

生产环境中需确保两个关键路径的权限正确：

• 存储目录：storage/app/local/ 需允许Web服务器用户（如www-data）读写
• 临时目录：/tmp/ 需允许Web服务器用户读写

执行以下命令修复权限（根据实际用户调整）：

chown -R www-data:www-data storage/
chmod -R 755 storage/
chmod 775 /tmp/ # 比777更安全，确保所属组有读写权限

3. 检查临时目录状态 #

• 确认/tmp所在磁盘分区是否已满，执行df -h查看
• 清理过期临时文件，避免目录被占满

4. 验证文件完整性 #

在生产环境中检查文件是否为有效PNG：

file /path/to/storage/app/local/$date/folder-name/$fileName.png

正常输出应为PNG image data, ...，若显示其他内容，说明API返回的文件内容在生产环境中存在损坏或截断。

5. 调整Intervention Image驱动 #

检查config/image.php中的驱动配置，生产环境可尝试切换为Imagick（已安装且支持PNG）：

'driver' => 'imagick',

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