Symfony EasyAdmin中ChoiceField关联Enum报错，如何正确配置？

核心问题分析 #

你遇到的错误根源是实体属性类型与ORM枚举配置不匹配：ORM注解指定了enumType，但属性类型却是?string，导致Doctrine和EasyAdmin在类型转换时出现冲突——Doctrine从数据库读取枚举值会映射为OGTypeStatus对象，但实体属性只能接收字符串；提交时EasyAdmin传递的字符串又无法被当作Enum对象处理。

正确配置步骤 #

1. 修正实体属性类型

将实体中对应字段的类型从?string改为?OGTypeStatus（你的枚举类），同时确保ORM注解正确关联枚举：

use App\Enum\OGTypeStatus;
use Doctrine\ORM\Mapping as ORM;

class YourEntity
{
    // ...

    #[ORM\Column(type: 'string', enumType: OGTypeStatus::class)]
    private ?OGTypeStatus $ogTypeStatus = null;

    // 同步更新getter/setter的类型声明：
    public function getOgTypeStatus(): ?OGTypeStatus
    {
        return $this->ogTypeStatus;
    }

    public function setOgTypeStatus(?OGTypeStatus $ogTypeStatus): self
    {
        $this->ogTypeStatus = $ogTypeStatus;

        return $this;
    }
}

2. 调整EasyAdmin的ChoiceField配置

当实体属性是Enum类型时，EasyAdmin（Symfony 6.1+、EasyAdmin 4.4+版本）会自动识别枚举并生成选项，无需手动调用setChoices()：

use EasyCorp\Bundle\EasyAdminBundle\Field\ChoiceField;

class YourEntityCrudController extends AbstractCrudController
{
    public function configureFields(string $pageName): iterable
    {
        // ...
        yield ChoiceField::new('ogTypeStatus');
        
        // 如需自定义选项显示文本，可添加以下配置（示例用枚举名称作为显示文本）：
        // ->setChoices(fn () => array_reduce(OGTypeStatus::cases(), function ($choices, OGTypeStatus $case) {
        //     $choices[$case->name] = $case;
        //     return $choices;
        // }, []))
    }
}

3. 处理数据库迁移

由于属性类型从字符串改为Enum，需要生成并执行Doctrine迁移，确保数据库字段与实体配置一致：

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

4. 验证修复效果

• 索引页/详情页：Doctrine会将数据库字符串值正确映射为OGTypeStatus枚举对象，实体属性类型匹配，不再抛出赋值错误；
• 新建/编辑页：EasyAdmin会自动将表单提交的枚举选项转换为OGTypeStatus对象，传递给实体的setter，避免“读取value属性”的警告。

旧版本兼容说明 #

如果你的Symfony <6.1或EasyAdmin <4.4，需要手动处理类型转换：

1. 在ChoiceField中手动指定枚举选项：

ChoiceField::new('ogTypeStatus')
    ->setChoices(OGTypeStatus::cases())
    ->setFormTypeOption('choice_label', fn(OGTypeStatus $case) => $case->name);

2. 在实体setter中手动将字符串转换为枚举对象：

public function setOgTypeStatus(?string $ogTypeStatus): self
{
    $this->ogTypeStatus = $ogTypeStatus ? OGTypeStatus::from($ogTypeStatus) : null;
    return $this;
}

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