ThinkPHP图片处理不依赖事件自动触发，必须显式调用Image类方法（如crop、thumb、save）；Image::open()需传本地绝对路径并确保GD/Imagick扩展启用、目录可写、格式真实有效，且save()须检查返回值以捕获错误。
Image 类方法完成的。你如果在控制器里写 $image->crop()->save()，它就执行；不写，就不会发生。所谓“事件”，比如 before_write 或自定义钩子，需要你自己手动挂载逻辑，框架不会自动对上传图片做裁剪或加水印。
为什么不能依赖事件自动处理图片？
ThinkPHP 的事件系统（如 Hook、Event）默认不监听文件上传或图片变更行为。上传动作由 Request 或 File 类完成，Image 类是纯工具类，无生命周期感知能力。想让它介入，必须人工插入调用点。
- 上传成功后，你得在控制器里主动实例化
Image并打开刚存的文件路径，否则没人知道该处理哪张图 - 如果你用了模型事件（如
after_insert），要注意：此时图片可能还没落地（比如只拿到临时路径），Image::open()会失败 - 异步场景（如队列处理缩略图）更不能靠事件“自动触发”，得显式投递任务并传入真实路径
Image::open() 打不开上传后的图片？检查这三点
常见报错 imagecreatefromjpeg(): gd-jpeg: JPEG library reports unrecoverable error 或直接返回 false，多数不是代码写错，而是路径/权限/格式问题。
-
Image::open()接收的是**服务器本地绝对路径**，不是 URL 或相对路径。例如ROOT_PATH . 'public/uploads/' . $info->getSaveName()，而不是/uploads/xxx.jpg - 确保 GD 扩展已启用：
php -m | grep gd；若用 Imagick，确认extension=imagick已加载且支持对应格式（如 WebP） - 上传时若未校验 MIME 类型，可能混入伪 JPG（如 HTML 文件改后缀），
Image::open()会静默失败。建议上传后先用finfo_file()校验真实类型
thumb() 为什么生成的图不是指定宽高？
默认模式 Image::IMAGE_THUMB_SCALE（值为 1）只保证“最长边 ≤ 指定值”，不拉伸不变形。想得到严格 100×100 的图，必须显式指定缩略图模式：
- 填充模式（保持比例 + 背景填色）：
$image->thumb(100, 100, Image::IMAGE_THUMB_FILLED)->save($path) - 居中裁剪（暴力切出 100×100）：
$image->thumb(100, 100, Image::IMAGE_THUMB_CENTER)->save($path) - 固定尺寸拉伸（慎用，易变形）：
$image->thumb(100, 100, Image::IMAGE_THUMB_FIXED)->save($path)
注意：Image::IMAGE_THUMB_CENTER 在部分旧版 TP5.0 中常量名是 IMAGE_THUMB_CENTER（无前缀 Image::），需查你所用版本的 thinkphp/library/think/Image.php 源码确认定义。
立即学习“PHP免费学习笔记（深入）”；
链式调用后 save() 失败但没报错？
save() 默认返回布尔值，失败时不抛异常，容易被忽略。尤其在 CLI 环境或日志关闭时，你会以为“执行了”，其实图根本没存上。
- 务必检查返回值：
if (false === $image->crop(200, 200)->save($dst)) { throw new \Exception('图片保存失败：' . $image->getError()); } -
$image->getError()是唯一能拿到具体原因的入口，可能是目录不可写、磁盘满、不支持输出格式（如原图是 WebP，但 GD 未编译 WebP 支持） - 目标路径的父目录必须存在且可写，
save()不会自动创建多级目录，得提前用mkdir(..., 0755, true)
Image 操作都只是空转。别迷信“写了 crop 就一定裁了”，先确认 open() 返回了有效资源对象。 
