Magento 2.4.6中构造函数属性提升与DI可选参数兼容问题

报错原因 #

Magento 2.4.6的DI容器对PHP 8构造函数属性提升的支持存在局限性：当用属性提升声明带默认值=null的可选依赖时，DI系统会错误地将其判定为必须注入的强制依赖，直接忽略默认值的设定。容器尝试实例化Optional类时，若该类无对应DI配置或无法自动实例化，就会抛出“dependency injection cannot be null”错误。

而传统写法中，将Optional参数从属性提升中剥离，仅作为普通构造参数接收后赋值给类属性，DI容器能正确识别它是可选参数，允许传入null，因此不会报错。

可行解决方法 #

方法1：保留传统构造写法（最稳妥）

放弃对可选依赖使用属性提升，单独声明类属性，在构造函数中接收参数并手动赋值：

private $optional;
public function __construct(
    private MethodInjection $methodInjection,
    Optional $optional = null,
    private array $data = []
) {
    $this->optional = $optional;
}

方法2：配置DI文件标记可选依赖

在模块的etc/di.xml中为目标类配置可空参数，明确告诉DI容器该依赖允许为null：

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <type name="Your\Module\Path\To\YourClass">
        <arguments>
            <argument name="optional" xsi:type="object" nullable="true"/>
        </arguments>
    </type>
</config>

如果Optional是接口，也可以绑定一个空实现作为默认值，避免容器找不到实例：

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <preference for="Your\Module\Api\OptionalInterface" type="Your\Module\Model\EmptyOptional"/>
</config>

随后创建EmptyOptional类实现对应的接口，作为默认注入实例即可。

方法3：使用PHP可空类型声明（需测试兼容性）

给参数类型添加?标记明确可空，帮助DI容器识别可选性：

public function __construct(
    private MethodInjection $methodInjection,
    private ?Optional $optional = null,
    private array $data = []
) {
    
}

注：此方法在部分Magento版本中可能生效，但不是所有场景都适用，建议测试后使用。

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