Ubuntu22.04下Magento2.4.7-beta1+PHP8.2编译Amasty模块报错求助

问题描述 #

将运行正常的 Magento 2.4.2 + PHP7.4 网站通过Composer升级到 Magento 2.4.7-beta1 + PHP8.2 后，移除第三方Amasty模块时执行sudo php bin/magento setup:di:compile可正常完成；但保留该模块时，编译到代码生成阶段（1/9，11%）触发PHP致命错误：

无法声明类Amasty\AdminActionsLog\lib\HtmlNode，因为该名称已在/var/www/html/mydomain.com/app/code/Amasty/AdminActionsLog/lib/HtmlNode.php的第6行（代码为class HtmlNode {）被使用。

相关模块文件代码片段：

1. app\code\Amasty\AdminActionsLog\lib\HtmlNode.php

<?php
namespace Amasty\AdminActionsLog\lib;
include_once 'HtmlNodeText.php';
include_once 'HtmlSelector.php';
class HtmlNode {
    const NODE_ELEMENT = 0;

2. app\code\Amasty\AdminActionsLog\lib\HtmlNodeCdata.php

<?php
namespace Amasty\AdminActionsLog\lib;
class HtmlNodeCdata extends HtmlNode {

3. app\code\Amasty\AdminActionsLog\lib\HtmlNodeComment.php

<?php
namespace Amasty\AdminActionsLog\lib;
class HtmlNodeComment extends HtmlNode {

原因分析 #

• PHP8.0+ 对类重复声明的检测机制比PHP7.4严格得多，尤其是在手动include_once和自动加载混合使用的场景下。
• PHP7.4会忽略类的重复声明尝试，不会抛出错误；但PHP8.2会直接触发致命错误终止编译。
• 核心问题是HtmlNode.php中的include_once调用，结合Magento DI编译时的自动加载机制，导致HtmlNode类被两次尝试声明：一次是手动包含触发，一次是自动加载器加载。

修复方案 #

方案1：替换手动包含为自动加载（推荐） #

Magento遵循PSR-4自动加载规范，直接移除HtmlNode.php里的手动包含语句，让自动加载器处理依赖：
修改app\code\Amasty\AdminActionsLog\lib\HtmlNode.php：

<?php
namespace Amasty\AdminActionsLog\lib;
// 移除以下两行手动包含代码
// include_once 'HtmlNodeText.php';
// include_once 'HtmlSelector.php';
class HtmlNode {
    const NODE_ELEMENT = 0;

只要HtmlNodeText.php和HtmlSelector.php的命名空间与文件路径匹配，自动加载器会自动找到并加载这些文件。

方案2：确保类仅被加载一次（临时方案） #

如果必须保留手动包含逻辑，可在继承类文件中先检查类是否存在再加载：
修改app\code\Amasty\AdminActionsLog\lib\HtmlNodeCdata.php：

<?php
namespace Amasty\AdminActionsLog\lib;
if (!class_exists(HtmlNode::class)) {
    include_once 'HtmlNode.php';
}
class HtmlNodeCdata extends HtmlNode {

对HtmlNodeComment.php执行同样修改。不过这种方式不符合Magento开发规范，仅作为临时修复使用。

方案3：升级Amasty模块到兼容版本 #

直接下载Amasty官方发布的、适配PHP8.2和Magento 2.4.7的模块版本，这是最彻底的解决方案，避免自行修改代码带来的后续维护风险。

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