Symfony 5.3引入外部Bundle报错：无法加载EmailBundle类

我正在使用Symfony 5.3，希望在项目中引入两个独立仓库。项目的composer.json配置如下：

"require": {
    "bundlezone/emailer": "dev-release/develop-setup",
    "bundlezone/tester": "dev-master"
}

Emailer仓库的composer.json自动加载配置如下：

"autoload" : {
"psr-4" : {
  "BundleZone\\Emailer\\": [""],
  "": ["Emailer"]
 }
},

Tester仓库的composer.json自动加载配置如下：

"autoload" : {
"psr-4" : {
  "BundleZone\\Tester\\": [""],
  "": ["Tester"]
 }
},

Emailer仓库包含多个Bundle，其中EmailBundle.php代码如下：

<?php

namespace EmailBundle;

use Symfony\Component\HttpKernel\Bundle\Bundle;

class EmailBundle extends Bundle
{

}

我已将该类添加到项目的config/bundles.php中：

\EmailBundle\EmailBundle::class => ['all' => true],

但仍抛出如下错误：

Attempted to load class "EmailBundle" from namespace "EmailBundle".
Did you forget a "use" statement for another namespace?

问题根源及修复方案 #

• 自动加载规则与文件路径、命名空间不匹配：Emailer仓库的PSR-4配置里，根命名空间（""）被映射到Emailer目录，意味着所有非BundleZone\Emailer命名空间的类，都应该放在仓库的Emailer目录下。但你的EmailBundle.php使用EmailBundle命名空间，若文件直接放在仓库根目录，自动加载器会去Emailer/EmailBundle.php路径查找，找不到对应文件导致加载失败。

• 具体修复步骤：

  1. 调整自动加载配置：根据文件实际路径修改Emailer仓库的composer.json：

     • 若EmailBundle.php直接在Emailer仓库根目录（即vendor/bundlezone/emailer/EmailBundle.php），更新规则：

       "autoload" : {
         "psr-4" : {
           "BundleZone\\Emailer\\": "",
           "EmailBundle\\": ""
         }
       }
       

     • 若EmailBundle.php放在仓库的EmailBundle子目录（即vendor/bundlezone/emailer/EmailBundle/EmailBundle.php），则规则改为：

       "autoload" : {
         "psr-4" : {
           "BundleZone\\Emailer\\": "",
           "EmailBundle\\": "EmailBundle/"
         }
       }
       

  2. 更新自动加载文件：在项目根目录执行命令：

     composer dump-autoload
     

  3. 验证一致性：确保EmailBundle.php的命名空间和文件路径严格遵循PSR-4规范——命名空间分段对应目录结构，类文件名与类名完全一致。

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