Sonata Admin中ModelType无法持久化OneToMany关联变更问题

问题场景 #

使用Sonata Admin Bundle的ModelType::class处理Banner与Pagina的OneToMany关联时，表单能正常加载关联数据，但提交后关联关系的修改无法被持久化，其他字段功能正常。

实体定义 #

Banner实体（关联拥有方） #

class Banner implements TranslatableInterface
{
    // ...其他属性

    #[ORM\OneToMany(mappedBy: 'banner', targetEntity: Pagina::class)]
    private Collection $paginas;
    
    public function __construct()
    {
        $this->paginas = new ArrayCollection();
    }

    public function getPaginas(): Collection
    {
        return $this->paginas;
    }

    public function addPagina(Pagina $pagina): static
    {
        if (!$this->paginas->contains($pagina)) {
            $this->paginas->add($pagina);
            $pagina->setBanner($this);
        }

        return $this;
    }

    public function removePagina(Pagina $pagina): static
    {
        if ($this->paginas->removeElement($pagina)) {
            if ($pagina->getBanner() === $this) {
                $pagina->setBanner(null);
            }
        }

        return $this;
    }

    // ...其他方法
}

Pagina实体（关联 inverse 方） #

class Pagina implements TranslatableInterface, TreeNodeInterface
{
    // ...其他属性

    #[ORM\ManyToOne(inversedBy: 'paginas')]
    private ?Banner $banner = null;

    // ...对应的getBanner/setBanner方法
}

当前Sonata Admin配置 #

final class BannerAdmin extends AbstractAdmin
{
    // ...其他配置

    protected function configureFormFields(FormMapper $form): void
    {
        $form->add('paginas');
        // 曾尝试以下配置，但无效
        // $form->add('paginas', ModelType::class, ['multiple' => true,]);
    }

    // ...其他方法
}

核心原因 #

处理双向OneToMany关联时，Sonata Admin默认直接操作集合对象，而非调用实体的addPagina/removePagina方法，导致双向关联的同步逻辑未被触发，最终Doctrine无法检测到关联变更。

解决方法 #

修改BannerAdmin中的表单字段配置，添加by_reference: false参数，强制表单调用实体的add/remove方法：

protected function configureFormFields(FormMapper $form): void
{
    $form->add('paginas', ModelType::class, [
        'multiple' => true,
        'by_reference' => false, // 关键配置
    ]);
}

额外检查项 #

1. 确保Pagina实体的setBanner方法正确实现，能够接受null值以解除关联
2. 若需要自动级联保存/删除关联对象，可在Banner实体的OneToMany注解中添加级联配置：

   #[ORM\OneToMany(mappedBy: 'banner', targetEntity: Pagina::class, cascade: ['persist', 'remove'])]
   

环境配置（composer.json） #

{
    "type": "project",
    "license": "proprietary",
    "minimum-stability": "stable",
    "prefer-stable": true,
    "require": {
        "php": ">=8.1",
        "ext-ctype": "*",
        "ext-iconv": "*",
        "doctrine/doctrine-bundle": "^2.11",
        "doctrine/doctrine-migrations-bundle": "^3.3",
        "doctrine/orm": "^2.17",
        "friendsofsymfony/ckeditor-bundle": "^2.4",
        "gedmo/doctrine-extensions": "^3.13",
        "knplabs/doctrine-behaviors": "^2.6",
        "knplabs/knp-paginator-bundle": "^6.3",
        "liip/imagine-bundle": "^2.12",
        "phpdocumentor/reflection-docblock": "^5.3",
        "phpstan/phpdoc-parser": "^1.24",
        "sonata-project/doctrine-orm-admin-bundle": "*",
        "sonata-project/formatter-bundle": "*",
        "sonata-project/translation-bundle": "^3.3",
        "sonata-project/user-bundle": "*",
        "symfony/asset": "6.3.*",
        "symfony/console": "6.3.*",
        "symfony/doctrine-messenger": "6.3.*",
        "symfony/dotenv": "6.3.*",
        "symfony/expression-language": "6.3.*",
        "symfony/flex": "^2",
        "symfony/form": "6.3.*",
        "symfony/framework-bundle": "6.3.*",
        "symfony/http-client": "6.3.*",
        "symfony/intl": "6.3.*",
        "symfony/mailchimp-mailer": "6.3.*",
        "symfony/mailer": "6.3.*",
        "symfony/mime": "6.3.*",
        "symfony/monolog-bundle": "^3.0",
        "symfony/notifier": "6.3.*",
        "symfony/process": "6.3.*",
        "symfony/property-access": "6.3.*",
        "symfony/property-info": "6.3.*",
        "symfony/runtime": "6.3.*",
        "symfony/security-bundle": "6.3.*",
        "symfony/serializer": "6.3.*",
        "symfony/string": "6.3.*",
        "symfony/translation": "6.3.*",
        "symfony/twig-bundle": "6.3.*",
        "symfony/validator": "6.3.*",
        "symfony/web-link": "6.3.*",
        "symfony/yaml": "6.3.*",
        "twig/extra-bundle": "^2.12|^3.0",
        "twig/twig": "^2.12|^3.0",
        "vich/uploader-bundle": "^2.2"
    },
    "config": {
        "allow-plugins": {
            "php-http/discovery": true,
            "symfony/flex": true,
            "symfony/runtime": true
        },
        "sort-packages": true
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "App\\Tests\\": "tests/"
        }
    },
    "replace": {
        "symfony/polyfill-ctype": "*",
        "symfony/polyfill-iconv": "*",
        "symfony/polyfill-php72": "*",
        "symfony/polyfill-php73": "*",
        "symfony/polyfill-php74": "*",
        "symfony/polyfill-php80": "*",
        "symfony/polyfill-php81": "*"
    },
    "scripts": {
        "auto-scripts": {
            "cache:clear": "symfony-cmd",
            "assets:install %PUBLIC_DIR%": "symfony-cmd",
            "ckeditor:install": "symfony-cmd"
        },
        "post-install-cmd": [
            "@auto-scripts"
        ],
        "post-update-cmd": [
            "@auto-scripts"
        ]
    },
    "conflict": {
        "symfony/symfony": "*"
    },
    "extra": {
        "symfony": {
            "allow-contrib": false,
            "require": "6.3.*"
        }
    },
    "require-dev": {
        "phpunit/phpunit": "^9.5",
        "symfony/browser-kit": "6.3.*",
        "symfony/css-selector": "6.3.*",
        "symfony/debug-bundle": "6.3.*",
        "symfony/maker-bundle": "^1.52",
        "symfony/phpunit-bridge": "^7.0",
        "symfony/stopwatch": "6.3.*",
        "symfony/web-profiler-bundle": "6.3.*"
    }
}

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