Symfony 6+EasyAdmin 4多文件上传报错：Project类不可上传

报错“The class "App\Entity\Project" is not uploadable.”的核心原因是Project实体未正确配置VichUploader的上传规则，以下是必查的几个关键节点：

• 检查Project实体是否添加#[Vich\Uploadable]注解，同时引入正确的命名空间：

  // App\Entity\Project.php
  use Vich\UploaderBundle\Mapping\Annotation as Vich;
  
  #[Vich\Uploadable]
  class Project
  {
      // ... 实体其他代码
  }
  

• 确认实体内存在对应Vich上传的字段组合：一个File类型的临时存储字段（配合#[Vich\UploadableField]注解），以及一个存储文件名的字段：

  use Symfony\Component\HttpFoundation\File\File;
  
  // ...
  
  #[Vich\UploadableField(mapping: 'project_images', fileNameProperty: 'imageName')]
  private ?File $imageFile = null;
  
  private ?string $imageName = null;
  

• 核对vich_uploader配置文件（config/packages/vich_uploader.yaml），确保注解中使用的映射名称（如project_images）已正确定义：

  vich_uploader:
    db_driver: orm
    mappings:
      project_images:
        uri_prefix: '%app.path.project_images%'
        upload_destination: '%kernel.project_dir%/public%app.path.project_images%'
        namer: Vich\UploaderBundle\Naming\UniqidNamer
  

• 如果你是通过关联ProjectImage实体实现多图上传，错误可能是在CrudController里错误地给Project实体配置了上传字段。这种场景下，应该在表单中嵌入ProjectImage的集合，而非将Project本身设为上传类。

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