VichUploader Bundle新增图片正常但更新图片失效问题求助

核心原因 #

更新操作时，Doctrine无法检测到imageFile属性的变更（File对象的改动不属于Doctrine默认追踪的属性变化类型），导致VichUploader未触发文件上传逻辑。

解决步骤 #

1. 为Project实体添加更新时间字段 #

在Project实体中新增updatedAt属性，并在setImageFile方法中同步更新时间戳，让Doctrine能感知实体变化：

use DateTimeInterface;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\HttpFoundation\File\File;
use Vich\UploaderBundle\Mapping\Annotation as Vich;

#[ORM\Entity(repositoryClass: ProjectRepository::class)]
#[Vich\Uploadable]
class Project
{
    #[Vich\UploadableField(mapping: 'projects', fileNameProperty: 'image')]
    private ?File $imageFile = null;

    #[ORM\Column(type: 'datetime')]
    private ?DateTimeInterface $updatedAt = null;

    // 其他属性与方法...

    public function setImageFile(?File $imageFile = null): void
    {
        $this->imageFile = $imageFile;

        // 仅当文件实际变更时更新时间戳
        if (null !== $imageFile) {
            $this->updatedAt = new \DateTimeImmutable();
        }
    }

    public function getUpdatedAt(): ?DateTimeInterface
    {
        return $this->updatedAt;
    }

    public function setUpdatedAt(DateTimeInterface $updatedAt): self
    {
        $this->updatedAt = $updatedAt;
        return $this;
    }
}

2. 更新数据库结构 #

运行Doctrine迁移命令，将新增的updatedAt字段同步到数据库：

php bin/console make:migration
php bin/console doctrine:migrations:migrate

3. 优化控制器更新逻辑（可选） #

通过find获取的实体已被Doctrine托管，无需调用persist()，直接执行flush()即可：

public function updateProject(Request $request, $id): Response
{
    $project = $this->em->getRepository(Project::class)->find($id);  
    $form = $this->createForm(ProjectType::class, $project);
    $form->handleRequest($request);
    if($form->isSubmitted() && $form->isValid()) {
        $this->em->flush();

        $this->addFlash('message', 'Project updated successfully.');
        return $this->redirectToRoute('list-project');
    }
    return $this->render('admin/add_project.html.twig', [
        'form' => $form,
    ]);
}

关键说明 #

其他模块功能正常，是因为它们已正确实现了updatedAt字段的更新逻辑；而Project实体缺失这一配置，导致Doctrine无法触发实体更新流程，最终VichUploader未执行文件上传操作。

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