EC2 Ubuntu20.04下PHP8已加载DOM模块仍报DOMDocument类错误求助

适用场景：Ubuntu 20.04 EC2实例、PHP8.0版本、phpinfo确认DOM/XML模块已加载、重启Apache后仍报错。

排查&修复步骤 #

• 优先检查命名空间引用问题
  这是该场景下最高发的原因：如果你的业务代码声明了自定义命名空间（比如namespace App\Utils;），直接调用DOMDocument时PHP会在当前命名空间下查找该类，不会自动加载全局内置类。
  修复方式：调用DOMDocument时补全全局命名空间前缀：

  // 错误写法（自定义命名空间下）
  $dom = new DOMDocument();
  // 正确写法
  $dom = new \DOMDocument();
  

  快速验证方式：在报错文件首部加测试代码：

  var_dump(class_exists('DOMDocument'), class_exists('\DOMDocument'));
  

  如果第二个输出为bool(true)、第一个输出为bool(false)，即可确认是命名空间问题。

• 核对Apache运行时的PHP配置，避免CLI与Web进程配置混淆
  很多人通过命令行执行php -m或CLI模式下的phpinfo确认模块加载，但Apache的mod_php/PHP-FPM加载的是独立的php.ini配置，和CLI环境不通用。
  操作方式：在站点根目录创建测试文件phpinfo_test.php，内容为<?php phpinfo();，通过浏览器访问该文件，核对两个配置项：

  1. 记录Loaded Configuration File的实际路径，确认该配置文件未被篡改
  2. 查找disable_classes配置项，确认DOMDocument未被加入禁用类列表
     测试完成后及时删除该测试文件，避免泄露服务器配置信息。

• 重新安装对应PHP版本的DOM依赖包
  Ubuntu 20.04默认源的PHP版本为7.4，如果是第三方源安装的PHP8.0，直接安装php-xml可能会拉取错误版本的依赖，需要指定版本号重装：

  sudo apt update
  sudo apt install --reinstall php8.0-xml php8.0-dom
  

  重装完成后重启对应服务：

  # mod_php模式执行
  sudo systemctl restart apache2
  # Apache+PHP-FPM模式额外执行
  sudo systemctl restart php8.0-fpm
  

• 清空缓存验证
  如果开启了OPcache，重启服务后硬刷新浏览器缓存（Ctrl+F5）再测试，避免旧代码缓存导致报错持续出现。

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