Symfony 6.2可复用Bundle路由未加载问题求助

以下是针对自定义Bundle路由无法加载问题的具体排查与解决步骤：

1. 确认Bundle类中已注册路由配置 #

Symfony不会自动加载Bundle内的路由文件，必须在Bundle类中显式配置路由加载逻辑。修改src/PluginBundle.php：

namespace Test\Plugin;

use Symfony\Component\HttpKernel\Bundle\Bundle;
use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;

class PluginBundle extends Bundle
{
    public function configureRoutes(RoutingConfigurator $routes): void
    {
        // 加载Bundle内的属性路由配置文件
        $routes->import('../config/routes/attributes.yaml');
        // 若直接使用控制器属性路由，也可改为：
        // $routes->import('../src/Controller/', 'attribute');
    }
}

2. 验证控制器的属性路由注解正确性 #

检查DefaultController.php中的路由注解是否符合Symfony 6+的属性语法规范：

namespace Test\Plugin\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class DefaultController extends AbstractController
{
    #[Route('/test-plugin/default', name: 'test_plugin_default')]
    public function defaultAction(): Response
    {
        return new Response('Hello from Plugin Bundle');
    }
}

确保已引入Route注解类，且路由路径无冲突。

3. 检查Bundle的composer.json配置 #

确认plugin-bundle/composer.json的自动加载与类型配置正确：

{
    "name": "test/plugin",
    "type": "symfony-bundle",
    "autoload": {
        "psr-4": {
            "Test\\Plugin\\": "src/"
        }
    },
    "require": {
        "symfony/framework-bundle": "^6.2"
    }
}

type设为symfony-bundle可帮助Symfony识别Bundle类型，psr-4命名空间需与代码结构完全匹配。

4. 彻底清除缓存 #

执行命令清除所有环境缓存，避免旧缓存干扰路由加载：

bin/console cache:clear --env=dev
# 或直接删除缓存目录
rm -rf var/cache/*

之后运行bin/console debug:router查看路由是否已加载。

5. 确认主应用已正确激活Bundle #

检查config/bundles.php中Bundle的注册状态：

return [
    // ...其他已注册Bundle
    Test\Plugin\PluginBundle::class => ['all' => true],
];

['all' => true]确保Bundle在所有环境下都被激活。

6. 主应用手动导入Bundle路由（备选方案） #

若上述步骤无效，可在主应用的config/routes.yaml中直接导入Bundle路由：

test_plugin_routes:
    resource: '@PluginBundle/config/routes/attributes.yaml'
    prefix: /test-plugin

@PluginBundle是Bundle的默认别名（与Bundle类名一致），若自定义过别名需对应修改。

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