图片模糊主因是插值算法粗糙，应显式指定interpolate并优先用imagick驱动；crop黑边因exif方向未处理，需先orientate()；上传后报错因临时文件被清理，应改用getrealpath()或store()；webp乱码需手动设content-type及nginx配置mime类型。
laravel-image 压缩后图片模糊？先确认是否用了 interpolation
默认用 imagick 或 gd 驱动时，缩放质量差的主因是插值算法太粗糙。laravel 的 Intervention Image 包（最常用）在 resize 时不显式指定插值方式，gd 会默认用 IMG_NEAREST_NEIGHBOR，锯齿感强、细节糊。
- 加
->interpolate(InterventionImageEnumsInterpolation::BICUBIC)显式指定高质量插值（仅imagick支持 BICUBIC；gd只支持BILINEAR或BEZIER） - 优先用
imagick驱动：安装ext-imagick，并在config/image.php中设'driver' => 'imagick' - 压缩前先 resize 到目标尺寸，再调
->encode('jpg', 85)—— 不要反过来，否则先压再缩会二次失真
crop() 裁剪区域偏移或黑边？检查坐标和图像方向
crop() 是按像素坐标的绝对操作，但实际图可能含 EXIF 方向信息（比如手机直拍的 JPG），Intervention Image 默认不自动旋转，导致你传的 x=100, y=100 其实落在了旋转后的图边缘外，结果裁出黑边或空图。
- 加载后立刻调
->orientate()：它会读 EXIF 并自动旋转+重置 orientation 标签 - 裁剪前用
->width()和->height()确认当前尺寸，别依赖原始文件宽高 - 若需居中裁剪固定尺寸（如 300×300），用
->fit(300, 300, 'center', 'center')更稳，它内部已处理坐标对齐和 overflow
上传后立刻 crop + compress 却报 Unable to read image from file
常见于用 Laravel 的 $request->file() 拿到临时文件后，直接传路径给 Image::make()，但临时文件可能已被 PHP 清理（尤其在某些 swoole 或 Octane 环境下，或用了 moveTo() 后原临时路径失效）。
- 别传路径，改用
Image::make($request->file('avatar')->getRealPath())——getRealPath()返回真实临时路径且确保未被删 - 更稳妥：先
$file->store('temp')存到 storage，再用Image::make(storage_path('app/' . $path)) - 如果用的是
IlluminatehttpUploadedFile实例，也可直接传对象：Image::make($file)，它会自动处理流
生成 WebP 但 Nginx 不识别 MIME 类型？
Laravel 用 ->encode('webp', 80) 能生成 WebP，但浏览器访问返回乱码或下载，通常是 Web 服务器没配 WebP 的 MIME 类型，或 Laravel 响应头没设对。
- 响应时手动加 header：
response($image->encode('webp', 80))->header('Content-Type', 'image/webp') - Nginx 需在配置里加：
types { image/webp webp; }，并 reload - 注意：safari 旧版（
标签做格式协商
WebP 的兼容性判断、EXIF 自动旋转的触发时机、以及临时文件生命周期——这三个点，线上最容易漏查，一出问题就卡在“明明代码一样，本地好使线上不行”。