Symfony 6父-子控制器间依赖注入的重复代码优化问题

下面提供几种可行的方案，彻底消除子控制器中重复声明父类依赖的问题：

方案1：使用Symfony自带的属性注入（Symfony 6.2+） #

Symfony 6.2及以上版本原生支持#[Autowire]属性注入，无需通过构造函数声明依赖。基础控制器的依赖直接通过属性注入，子类只需处理自身专属依赖即可，完全不用管父类的依赖项。

代码示例：

abstract class BaseController extends AbstractController
{
    #[Autowire]
    protected readonly SerializerInterface $serializer;

    #[Autowire]
    protected readonly ValidatorInterface $validator;

    #[Autowire]
    private readonly ResponseGenerator $responseGenerator;

    // 无需构造函数，依赖会自动注入
    // 工具方法可直接使用上述属性
}

class ChildController extends BaseController
{
    // 仅需声明子类专属依赖
    public function __construct(
        private readonly SomeRepository $someRepository,
        // 其他子类专属依赖
    ) {
        // 无需调用parent::__construct()，父类无构造函数
    }
}

注意：确保项目Symfony版本符合要求，且services.yaml中已开启自动装配（默认开启）。

方案2：封装基础依赖为单一服务 #

如果你的Symfony版本低于6.2，可以把基础控制器需要的所有依赖封装到一个独立的服务类中，让基础控制器仅注入这一个服务，子类只需传递该服务给父类构造函数，避免重复声明多个依赖。

步骤1：创建依赖封装类

// src/Service/ControllerDependencies.php
class ControllerDependencies
{
    public function __construct(
        public readonly SerializerInterface $serializer,
        public readonly ValidatorInterface $validator,
        public readonly ResponseGenerator $responseGenerator,
    ) {}
}

步骤2：修改基础控制器

abstract class BaseController extends AbstractController
{
    public function __construct(
        protected readonly ControllerDependencies $deps,
    ) {}

    // 工具方法中通过$this->deps->serializer、$this->deps->validator调用依赖
}

步骤3：简化子控制器构造函数

class ChildController extends BaseController
{
    public function __construct(
        ControllerDependencies $deps,
        private readonly SomeRepository $someRepository,
        // 其他子类专属依赖
    ) {
        parent::__construct($deps);
    }
}

后续父类新增依赖时，仅需修改ControllerDependencies类，所有子类无需任何改动，从根源解决重复声明问题。

方案3：利用AbstractController的容器快捷方法（不推荐，仅作临时方案） #

虽然直接调用服务容器不符合依赖注入的显式原则，但如果上述方案都不适用，可以在基础控制器中封装获取依赖的方法，借助AbstractController的get()方法：

abstract class BaseController extends AbstractController
{
    protected function getSerializer(): SerializerInterface
    {
        return $this->get(SerializerInterface::class);
    }

    protected function getValidator(): ValidatorInterface
    {
        return $this->get(ValidatorInterface::class);
    }

    protected function getResponseGenerator(): ResponseGenerator
    {
        return $this->get(ResponseGenerator::class);
    }

    // 工具方法调用上述方法获取依赖
}

class ChildController extends BaseController
{
    public function __construct(
        private readonly SomeRepository $someRepository,
        // 其他子类专属依赖
    ) {
        // 无需调用parent::__construct()
    }
}

该方案依赖服务容器，维护性较差，仅建议作为临时过渡方案使用。

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