Symfony 6.2中Vich Uploader自定义目录命名器报错：A namer must be configured

问题诊断 #

报错的核心原因是目录命名器的服务注册或配置存在冲突，导致Vich Uploader无法正确识别自定义命名器。结合你的配置，需从服务标签、命名器逻辑两方面修正。

修正步骤 #

1. 移除多余的服务标签 #

services.yaml中给VichNamer添加的vich.namedirectory标签属于冗余配置，会干扰Vich Uploader对自定义命名器的识别，直接移除该标签：

# services.yaml 中对应配置修改为
App\Service\Namers\VichNamer:
    public: true
# 移除下方的tags配置块

2. 修改命名器逻辑，返回实体ID #

当前VichNamer返回固定字符串，需调整为根据实体ID生成目录名，同时处理实体未持久化（ID为空）的边界情况：

<?php

namespace App\Service\Namers;

use Vich\UploaderBundle\Mapping\PropertyMapping;
use Vich\UploaderBundle\Naming\DirectoryNamerInterface;
// 替换为你实际关联的实体类，比如图片所属的Tattoo/Users实体
use App\Entity\Users;

class VichNamer implements DirectoryNamerInterface {

    public function directoryName(object $object, PropertyMapping $mapping): string {
        // 校验实体类型，避免非目标实体传入
        if (!$object instanceof Users) {
            throw new \InvalidArgumentException('仅支持Users实体');
        }
        
        // 处理实体未持久化的情况，可返回临时目录或抛出异常
        if (null === $object->getId()) {
            return 'temp';
        }

        return (string) $object->getId();
    }
    
}

3. 验证核心配置正确性 #

确认vich_uploader.yaml中的映射配置无误，当前配置已正确关联自定义命名器，无需修改：

vich_uploader:
    db_driver: orm
    metadata:
        type: attribute
    mappings:
        tattoo_images:
            uri_prefix: /images/
            upload_destination: '%kernel.project_dir%/public/images/'
            directory_namer: App\Service\Namers\VichNamer

4. 清理缓存并测试 #

执行缓存清理命令确保配置生效：

php bin/console cache:clear

完成后上传文件，即可自动根据实体ID生成对应文件夹，报错也会消失。

额外注意事项 #

• 确保实体已正确配置Vich Uploader的属性注解（如#[Vich\UploadableField]），且映射名称tattoo_images与实体配置一致。
• 若新建实体时上传文件（此时实体无ID），可根据业务需求选择临时目录存储，或调整业务逻辑先持久化实体再上传。

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