Sonata Admin报错admin.media需实现AdminInterface如何解决

报错和MediaAdmin类本身的实现无关——你继承AbstractAdmin的写法是正确的，错误来自服务容器的配置冲突：

• 你在services.yaml的全局配置中开启了自动装配、自动配置，且App\命名空间的自动加载范围覆盖了整个src/目录，没有排除src/Admin路径
• AbstractAdmin构造函数需要三个必填参数：管理员服务ID、绑定的模型类全限定名、关联的控制器名，这三个参数由Sonata Admin在处理sonata.admin服务标签时动态传入
• 全局自动加载会提前为App\Admin\MediaAdmin生成一个默认的普通服务，这个服务没有传入上述三个必填构造参数，属于无效实例。Sonata的编译流程在处理admin.media服务时，拉取到了这个无效的自动注册实例，就会抛出“未实现AdminInterface”的类型校验错误。

1. 调整services.yaml的自动加载排除规则，把Admin目录加入排除列表，避免容器自动注册无效的Admin普通服务：

App\:
    resource: '../src/'
    exclude:
        - '../src/DependencyInjection/'
        - '../src/Entity/'
        - '../src/Kernel.php'
        - '../src/Admin/' # 新增该行，排除Admin目录的自动服务注册

2. 清除缓存让新配置生效：

php bin/console cache:clear

可选优化（Sonata Admin 4.x+ 适用） #

如果你的Sonata Admin版本在4.0及以上，不需要手动在yaml里写admin服务配置，可以直接删掉admin.media的手动配置段，通过注解完成Admin注册，更简洁也不容易出现配置冲突：

<?php
namespace App\Admin;

use App\Entity\Media;
use Sonata\AdminBundle\Admin\AbstractAdmin;
use Sonata\AdminBundle\Attribute\AsAdmin;
use Sonata\AdminBundle\Datagrid\DatagridMapper;
use Sonata\AdminBundle\Datagrid\ListMapper;
use Sonata\AdminBundle\Form\FormMapper;
use Sonata\AdminBundle\Show\ShowMapper;
use Symfony\Component\Form\Extension\Core\Type\TextType;

// 加这个注解即可完成注册，不需要写yaml配置
#[AsAdmin(modelClass: Media::class, managerType: 'orm', label: 'Media')]
final class MediaAdmin extends AbstractAdmin
{
    protected function configureFormFields(FormMapper $form): void
    {
        $form->add('name', TextType::class);
    }

    protected function configureDatagridFilters(DatagridMapper $datagrid): void
    {
        $datagrid->add('name');
    }

    protected function configureListFields(ListMapper $list): void
    {
        $list->addIdentifier('name');
    }

    protected function configureShowFields(ShowMapper $show): void
    {
        $show->add('name');
    }
}

如果上述操作完成后还是报错，依次检查两点：

• 确认sonata-project/admin-bundle的版本和当前项目的Symfony版本兼容，大版本不匹配会导致接口类型校验异常
• 确认App\Entity\Media实体类真实存在，命名空间、路径配置正确，模型类加载失败也会导致Admin服务初始化异常

内容的提问来源于stack exchange，提问作者Helder da Costa