symfony 6.4 中 vichuploaderbundle 删除数据库记录时默认不删文件，需监听 vich_uploader.pre_remove 事件安全清理；更新图片时还需监听 pre_upload 清理旧文件，确保文件与数据库状态同步。
在 Symfony 6.4 中使用 VichUploaderBundle，删除数据库记录时**默认不会自动删除对应上传的文件**。这是设计使然：Bundle 聚焦于“上传与持久化协同”，而非“级联物理清理”。要实现删库即删文件，需显式介入生命周期事件——最可靠的方式是监听 vich_uploader.pre_remove 事件。
为什么不能依赖 Doctrine 的 preRemove？
Doctrine 的 @ORM\PreRemove 在实体被标记为“待删除”但尚未 flush 时触发，此时 $entity->getImageName() 仍可读取，但 Vich 的文件元数据（如原始路径、临时句柄）可能已释放或不可靠。更重要的是，VichUploaderBundle 自身不在此阶段管理文件移动/清理逻辑，它只在上传流程中主动操作文件系统。
因此，直接在实体里写 @ORM\PreRemove 并调用 unlink() 容易失败或漏删，尤其当映射配置了自定义 namer 或多环境路径时。
推荐做法：监听 vich_uploader.pre_remove 事件
VichUploaderBundle 提供了专用事件 vich_uploader.pre_remove，它在 Bundle 内部确认该实体将被移除、且文件信息（如完整路径）仍完全可用时触发。此时调用 unlink() 最安全。
- 创建一个事件监听器类，实现
EventSubscriber - 在
getSubscribedEvents()中返回['vich_uploader.pre_remove'] - 在回调方法中获取实体、构建绝对路径、执行删除
- 注意检查文件是否存在，避免
unlink()报错
示例关键代码：
namespace App\EventListener;use Vich\UploaderBundle\Event\UploadEvent;
use Vich\UploaderBundle\Templating\Helper\UploaderHelper;
use Symfony\Component\Filesystem\Filesystem;
class VichFileCleanupListener
{
private Filesystem $filesystem;
private UploaderHelper $uploaderHelper;
public function __construct(Filesystem $filesystem, UploaderHelper $uploaderHelper)
{
$this->filesystem = $filesystem;
$this->uploaderHelper = $uploaderHelper;
}
public function onPreRemove(UploadEvent $event): void
{
$entity = $event->getSubject();
if (!$entity instanceof \App\Entity\Product) {
return;
}
$filePath = $this->uploaderHelper->asset($entity, 'imageFile');
// asset() 返回的是 URL 路径（如 /uploads/products/abc.jpg），需转为服务器绝对路径
$absolutePath = $_SERVER['DOCUMENT_ROOT'] . $filePath;
if ($this->filesystem->exists($absolutePath)) {
$this->filesystem->remove($absolutePath);
}
}
}
补充：确保旧文件清理不遗漏
仅处理 pre_remove 不够——如果用户只是更新图片（非删除整条记录），旧文件也会残留。这时应同时监听 vich_uploader.pre_upload 事件，在新文件写入前清理原文件：
- 在
pre_upload回调中，先读取当前$entity->getImageName() - 若不为空，拼出旧文件绝对路径并
remove() - 再让 Bundle 继续执行新上传逻辑
这样就覆盖了“更新替换”和“彻底删除”两种场景，真正实现文件与数据库状态严格同步。
注意事项与边界情况
不要在监听器中调用 $em->flush() 或修改实体状态，这会干扰当前事务；所有文件操作必须基于 Filesystem 组件（而非裸 unlink()），保证跨平台兼容性；若使用云存储适配器（如 Flysystem S3），监听器中应注入对应 FilesystemOperator 并调用其 delete() 方法，而非操作本地路径。
