Symfony 4 文件上传报错求助：文件不存在问题

嘿，我看到你照着官方文档实现Symfony 4文件上传时碰到这个报错了，结合你贴的代码，给你梳理几个最可能的排查方向，帮你定位问题：

一、表单配置的核心检查 #

• 首先确认表单类里的brochure字段是FileType类型，并且开启了映射（如果要关联实体的话）：

  // 你的表单类示例代码
  use Symfony\Component\Form\Extension\Core\Type\FileType;
  
  $builder->add('brochure', FileType::class, [
      'label' => '上传文件',
      'mapped' => true, // 必须开启，才能关联到实体的brochure属性
      'required' => true, // 根据需求调整是否必填
  ]);
  

• 前端表单一定要加enctype="multipart/form-data"，没有这个属性浏览器根本不会发送文件数据，这是文件上传的必备条件：

  {# Twig模板里的表单渲染代码 #}
  {{ form_start(form, {'attr': {'enctype': 'multipart/form-data'}}) }}
  

二、实体属性与方法的正确性 #

• 你的实体中brochure应该是字符串类型（用来存储上传后的文件名），要确保Doctrine映射注解正确：

  use Doctrine\ORM\Mapping as ORM;
  
  /**
   * @ORM\Column(type="string", length=255)
   */
  private $brochure;
  

• 注意你的setBrochure方法参数——实体最终存储的是文件名（字符串），而不是UploadedFile对象。如果直接把UploadedFile传给这个方法，后续处理时就可能出现空文件的错误。正确的逻辑是：通过事件监听器处理文件上传，把生成的文件名传给setBrochure。

三、FileUploader服务与事件监听的关键排查 #

• 先确认FileUploader服务已经正确注册到Symfony容器，并且注入了正确的目标目录：

  # config/services.yaml
  services:
      App\Service\FileUploader:
          arguments:
              $targetDirectory: '%kernel.project_dir%/public/uploads' # 确保这个目录存在且有写入权限
  

• 你的错误提示「The file "" does not exist」，很大概率是因为触发upload方法时传入的不是有效的UploadedFile对象，而是空字符串。要检查事件监听器（比如PrePersist/PreUpdate事件）里的逻辑：

  // 示例事件订阅者代码，用来处理文件上传
  use Doctrine\Bundle\DoctrineBundle\EventSubscriber\EventSubscriberInterface;
  use Doctrine\ORM\Events;
  use Doctrine\Persistence\Event\LifecycleEventArgs;
  use Symfony\Component\HttpFoundation\File\UploadedFile;
  
  class BrochureUploadSubscriber implements EventSubscriberInterface
  {
      private $uploader;
  
      public function __construct(FileUploader $uploader)
      {
          $this->uploader = $uploader;
      }
  
      public function getSubscribedEvents()
      {
          return [Events::prePersist, Events::preUpdate];
      }
  
      public function prePersist(LifecycleEventArgs $args)
      {
          $this->handleFileUpload($args->getObject());
      }
  
      public function preUpdate(LifecycleEventArgs $args)
      {
          $this->handleFileUpload($args->getObject());
      }
  
      private function handleFileUpload($entity)
      {
          // 先判断当前实体是否是你要处理的类型
          if (!$entity instanceof YourEntity) {
              return;
          }
  
          $file = $entity->getBrochure();
          // 关键检查：确保$file是UploadedFile实例，而不是空值或字符串
          if (!$file instanceof UploadedFile) {
              return;
          }
  
          $fileName = $this->uploader->upload($file);
          $entity->setBrochure($fileName);
      }
  }
  

  如果跳过了$file instanceof UploadedFile的判断，当没有上传文件或者表单数据异常时，就会把空字符串传给upload方法，触发「文件不存在」的错误。

四、控制器表单处理的细节 #

• 控制器里处理表单提交时，不要手动重复处理文件上传（如果已经用了事件监听器的话），避免逻辑冲突：

  public function create(Request $request)
  {
      $entity = new YourEntity();
      $form = $this->createForm(YourEntityType::class, $entity);
      $form->handleRequest($request);
  
      if ($form->isSubmitted() && $form->isValid()) {
          // 这里不需要手动调用upload，事件监听器会自动处理
          $em = $this->getDoctrine()->getManager();
          $em->persist($entity);
          $em->flush();
  
          return $this->redirectToRoute('entity_list');
      }
  
      return $this->render('entity/create.html.twig', [
          'form' => $form->createView(),
      ]);
  }
  

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