Magento Commerce Cloud执行mftf generate:tests报错DOMDocument类未找到

架构老林

2026-7-16

解决Magento Commerce Cloud中vendor/bin/mftf generate:tests报DOMDocument类找不到的问题

核心排查方向：执行命令的PHP环境与你验证的环境不一致

你已经通过php -i确认扩展已启用，但大概率是你验证的PHP环境和执行MFTF命令的环境不是同一个（比如本地主机PHP vs Docker容器内PHP），以下是具体解决步骤：

步骤1：在Docker容器内验证扩展状态
不要在本地主机执行命令，先进入Magento Cloud的CLI容器：
```
./vendor/bin/ece-docker build:compose && docker-compose run --rm cli bash
```
进入容器后，执行以下命令确认dom和xml扩展是否存在：
```
php -m | grep dom
php -m | grep xml
```
如果输出为空，说明容器内确实没装扩展，需要重新配置Dockerfile。
步骤2：确保Dockerfile配置正确并生效
检查config/php目录下的Dockerfile，确认安装扩展的命令正确（需先安装依赖库再编译扩展）：
```
RUN apt-get update && apt-get install -y libxml2-dev \
    && docker-php-ext-install dom xml
```
然后强制重新构建容器，让配置生效：
```
./vendor/bin/ece-docker build:compose --force
```
步骤3：在容器内执行MFTF命令
所有MFTF操作必须在Docker容器内执行，避免使用本地主机的PHP环境。进入容器后，切换到项目根目录，执行：
```
vendor/bin/mftf generate:tests
```
步骤4：清除缓存并重置依赖
如果以上步骤仍无效，尝试清除MFTF生成的缓存文件，并重装依赖：
```
# 清除MFTF生成的测试文件
rm -rf dev/tests/functional/generated/
# 重装Composer依赖
composer install
```
步骤5：检查PHP.ini配置
在容器内找到PHP配置文件路径：
```
php -i | grep php.ini
```
打开对应的php.ini，确认extension=dom.so和extension=xml.so没有被注释（前面没有;），如果被注释，取消注释后重启容器。