Magento2升级后打印销售PDF报错$_localeResolver属性未定义

问题根因 #

该报错是Magento版本迭代后的常见兼容问题：从Magento 2.4.0及后续版本开始，核心的Magento\Sales\Model\Order\Pdf\Invoice类新增了$_localeResolver属性（用于PDF渲染时的本地化格式解析），你的自定义模块InvoicePdfimage重写了该核心类，但没有同步适配父类的属性定义和依赖注入逻辑，导致调用该属性时触发未定义提示。

排查修复步骤 #

• 第一步：核对父类原生定义
  打开核心原生类文件vendor/magento/module-sales/Model/Order/Pdf/Invoice.php，确认其类属性定义、构造函数参数列表，找到新增的$_localeResolver对应的依赖类为Magento\Framework\Locale\ResolverInterface，避免后续传参类型错误。
• 第二步：补全自定义类的属性声明
  打开报错的自定义类文件app/code/InvoicePdfimage/Model/Magento/Sales/Order/Pdf/Invoice.php，在类的属性定义区域添加如下声明：

  /**
   * 本地化解析器实例
   * @var \Magento\Framework\Locale\ResolverInterface
   */
  protected $_localeResolver;
  

• 第三步：补全构造函数依赖赋值
  找到自定义类的__construct构造方法：
  1. 将\Magento\Framework\Locale\ResolverInterface $localeResolver添加到构造方法的参数列表中，注意参数顺序要和父类构造方法的参数顺序保持一致，避免依赖注入错乱
  2. 在构造方法内部添加属性初始化逻辑：

  $this->_localeResolver = $localeResolver;
  

  3. 确认parent::__construct()调用时传入了父类需要的全部参数，不要遗漏升级后核心新增的其他依赖项。
• 第四步：重置缓存与生成代码
  在Magento根目录执行如下命令，清理缓存重新生成依赖注入类：

  bin/magento cache:clean
  bin/magento setup:di:compile
  

  执行完成后重新尝试打印发票PDF，即可验证报错是否消失。

兼容优化建议 #

如果自定义类不需要完全覆写父类构造逻辑，建议直接将构造方法的参数按父类签名透传，不要在自定义类的构造方法中重复定义父类已经声明的属性赋值逻辑，可以有效避免后续Magento版本升级时，核心类新增依赖导致同类属性未定义的报错。

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