GLPI项目PSR-4自动加载异常：重复命名空间致Trait未找到

核心排查方向 #

问题根源是命名空间声明与引用不匹配，加上GLPI自身有自定义自动加载机制，需同时覆盖代码修正、缓存清理、系统配置检查三个维度。

分步解决步骤 #

1. 修正所有文件的命名空间与引用 #

这是最关键的一步，很多情况是文件自身的命名空间写错了，而非仅use语句问题：

• 检查目标Trait/类文件的命名空间：比如src/Features/DCBreadcrumb.php顶部必须是namespace Glpi\Features;，不能写成namespace Glpi\Glpi\Features;
• 全局批量修正错误引用：

  # 替换所有use语句中的重复命名空间
  grep -rl "use Glpi\\\Glpi\\" ./src | xargs sed -i 's/use Glpi\\\Glpi\\\(.*\);/use Glpi\\\1;/g'
  
  # 替换文件自身错误的命名空间声明
  grep -rl "namespace Glpi\\\Glpi\\" ./src | xargs sed -i 's/namespace Glpi\\\Glpi\\\(.*\);/namespace Glpi\\\1;/g'
  
  # 替换代码中直接引用的重复命名空间（如new \Glpi\Glpi\...）
  grep -rl "\\\Glpi\\\Glpi\\" ./src | xargs sed -i 's/\\\Glpi\\\Glpi\\\(.*\)/\\\Glpi\\\1/g'
  

  Windows环境可使用Git Bash执行，或用编辑器的全局替换功能完成相同操作

2. 清空GLPI自身缓存 #

GLPI会缓存类映射、编译模板等内容，旧缓存会导致修正后的代码不生效：

• 删除files/_cache/目录下的所有文件及子目录
• 若存在files/_compiled/目录，一并清空该目录内容

3. 重新生成Composer自动加载映射 #

确保Composer的自动加载规则正确生效：

composer dump-autoload -o

执行后可检查vendor/composer/autoload_psr4.php文件，确认仅存在'Glpi\\' => array($baseDir . '/src')条目，无Glpi\Glpi\相关映射。

4. 检查GLPI自定义自动加载逻辑 #

GLPI未完全依赖Composer自动加载，需验证系统内置的加载规则：

• 打开inc/autoload.php，确认其中的自动加载函数没有硬编码Glpi\Glpi的路径映射
• 检查inc/define.php中引用类的代码（如报错的第636行），确保使用完整正确的命名空间，比如Glpi\DCRoom而非直接DCRoom

5. 验证PHP环境配置 #

• 检查PHP的include_path，确保没有包含旧的GLPI路径或错误目录，可通过以下命令查看：

  php -i | grep include_path
  

• 确保PHP版本符合GLPI要求（避免因版本兼容导致的自动加载异常）

后续验证 #

完成上述步骤后，可通过以下方式确认问题解决：

• 访问GLPI前端页面，检查是否再出现自动加载错误
• 执行GLPI系统检查命令（若支持）：

  php bin/console glpi:system:check
  

• 查看PHP错误日志，确认无Trait/Class not found相关报错

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