LiipImagineBundle 专责图像变换，VichUploaderBundle 仅负责文件存储与路径管理；前者在请求时按需生成缩略图并缓存，后者不支持任何图像处理，故必须组合使用才能实现上传存原图、访问自动压缩缩略。
直接用 LiipImagineBundle + VichUploaderBundle 组合就能实现：上传原图存一份，访问时按需生成压缩/缩略图，不额外写处理逻辑。
为什么不能只靠 VichUploaderBundle 做压缩？
VichUploaderBundle 负责把文件存到磁盘或对象存储，并注入 URL，但它不做任何图像变换。所谓“自动压缩”必须由另一个组件触发——LiipImagineBundle 就是干这个的，它在图片被请求时（比如模板里调用 imagine_filter）才真正执行缩放、裁剪、质量调整等操作。
- 如果你只配了
VichUploaderBundle，上传的仍是原始尺寸和质量，前端直接引用asset()就等于裸奔加载大图 -
LiipImagineBundle默认不干预上传流程，它只响应带滤镜的 URL 请求（如/media/cache/my_thumb/filename.jpg） - 两者分工明确：
Vich管“存”，Liip管“变”
上传后立刻生成缩略图？不推荐硬编码触发
有人想在 PostPersist 事件里手动调用 ImagineInterface::transformImage 预生成缩略图，这容易出问题：
- 生成路径依赖
Resolver配置，手动调用时若没设对data_root或缓存目录，文件可能写错位置甚至失败 - 并发上传时多个请求同时尝试生成同一张缩略图，可能因竞态导致缓存缺失或重复写入
- 没必要——
LiipImagineBundle的按需生成+文件系统缓存机制已经足够快，首次访问稍慢，后续全是静态文件直出 - 真要预热，用命令行更稳妥：
php bin/console liip:imagine:cache:resolve --filter=my_thumb images/products/123.jpg
关键配置项：quality、mode 和 data_root 必须对齐
缩略图模糊、拉伸变形、404 找不到图，90% 出在这三个地方：
-
quality写在filter_sets下层，不是顶层；错写成liip_imagine: quality: 75会静默失效 -
thumbnail滤镜的mode参数决定裁剪逻辑：inset是等比缩放不裁剪，outbound是强制填满并裁边——电商列表页几乎都该用outbound -
data_root必须指向你用VichUploaderBundle实际保存图片的物理路径，例如%kernel.project_dir%/public/images/products；如果Vich存到public/uploads，但Liip的data_root还是默认的public，就会找不到源图
典型正确配置片段：
liip_imagine:
loaders:
default:
filesystem:
data_root: '%kernel.project_dir%/public/images/products'
resolvers:
default:
web_path: ~
filter_sets:
product_list:
quality: 80
filters:
thumbnail: { size: [300, 300], mode: outbound }
background: { size: [300, 300], color: '#ffffff' }
模板里怎么写才不出错？
别直接对原始上传路径用 imagine_filter，必须确保路径可被 Liip 加载器识别：
- 错误写法：
{{ asset('uploads/' ~ product.imageName) | imagine_filter('product_list') }}—— 如果Vich把文件存在public/images/products/xxx.jpg，但这里拼的是uploads/xxx.jpg，filesystem加载器找不到源图 - 正确写法：在实体里加一个 getter 返回相对路径，例如
getPublicImagePath()返回'images/products/' ~ $this->imageName，然后模板里写{{ asset(product.publicImagePath) | imagine_filter('product_list') }} - 更稳的方式：用
Vich自带的vich_uploader_assetTwig 函数，它返回的路径已适配你的mappings配置：{{ vich_uploader_asset(product, 'imageFile') | imagine_filter('product_list') }}
最后提醒一句：web_path 解析器生成的缓存文件默认放在 public/media/cache，上线前确认 Web 服务器（Nginx/Apache）对该目录有读写权限，否则会 500 或空白图。
