Magento 2.4.5：继承AbstractHelper类提示未标记为API的问题咨询

问题场景 #

自定义助手类Vendor\Module\Helper\Customer继承\Magento\Framework\App\Helper\AbstractHelper时，代码检查工具抛出提示：

被继承的类'\Magento\Framework\App\Helper\AbstractHelper'未标记为API

相关代码：

<?php
namespace Vendor\Module\Helper;

use Magento\Framework\App\Helper\AbstractHelper;

class Customer extends AbstractHelper
{
    // 类逻辑代码
}

问题原因 #

这个提示来自代码检查工具（如PHPStan的Magento扩展、Magento官方代码规范检查）的严格规则：未标记@api注解的核心框架类被继承时会触发警告。AbstractHelper作为框架内部的基础抽象类，确实没有标注@api，但这是Magento官方设计的正常情况——官方自带的助手类也普遍继承该类（例如Magento\Customer\Helper\Data）。

解决办法 #

1. 局部忽略检查提示 #

在自定义助手类上添加注解，让检查工具忽略该规则：

<?php
namespace Vendor\Module\Helper;

use Magento\Framework\App\Helper\AbstractHelper;

/**
 * @phpstan-ignore MagentoApiRules.Rules.InheritFromApiOnly
 */
class Customer extends AbstractHelper
{
    // 类逻辑代码
}

如果是PHPMD触发的提示，可替换为对应规则的忽略注解：

/**
 * @SuppressWarnings(PHPMD)
 */
class Customer extends AbstractHelper
{
    // 类逻辑代码
}

2. 直接忽略提示（合法） #

无需修改继承逻辑，因为Magento官方允许助手类继承AbstractHelper，这个提示仅为代码检查工具的严格约束，不影响功能运行。若项目对代码规范要求不强制，可直接跳过该提示。

3. 调整全局检查规则（不推荐） #

若需全局关闭该规则，可在代码检查工具的配置文件中修改：

• 对于PHPStan，在phpstan.neon中添加规则排除：

rules:
    - !exclude MagentoApiRules.Rules.InheritFromApiOnly

• 对于Magento官方代码规范检查，修改phpcs.xml中的对应规则配置。

内容的提问来源于stack exchange，提问作者César Robledo