Symfony 6自定义Bundle路由加载报错：无法识别bundle_test命名空间

错误原因分析 #

报错提示无法加载bundle_test配置，是因为你在Bundle内的routes.yaml错误地将bundle_test作为根节点使用，但路由配置不需要自定义命名空间，Symfony路由组件直接解析路由条目，多余的根节点会被当作配置命名空间处理，而你没有对应的扩展类来解析它。

分步解决方案 #

1. 修正Bundle内的routes.yaml格式 #

删除routes.yaml中的bundle_test根节点，直接定义路由规则：

# src/Resources/config/routes.yaml
bundle_test_route:
    path: /routeInBundle
    controller: BundleTest\Controller\TestController::index

2. 正确配置Bundle路由加载（推荐方式） #

在Bundle的主类（如BundleTest.php）中通过configureRoutes方法导入路由，替代在扩展类中手动加载：

namespace BundleTest;

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

class BundleTest extends Bundle
{
    public function configureRoutes(RoutingConfigurator $routes): void
    {
        $routes->import('../Resources/config/routes.yaml');
    }
}

3. 配置Twig模板路径 #

同样在Bundle主类中添加Twig模板命名空间配置，让Symfony能识别Bundle内的模板：

namespace BundleTest;

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

class BundleTest extends Bundle
{
    public function configureRoutes(RoutingConfigurator $routes): void
    {
        $routes->import('../Resources/config/routes.yaml');
    }

    public function build(ContainerBuilder $container): void
    {
        parent::build($container);
        // 注册模板命名空间，后续控制器可通过@BundleTest引用模板
        $container->getExtension('twig')->addPath(__DIR__.'/Resources/views', 'BundleTest');
    }
}

4. 控制器中正确渲染模板 #

控制器继承AbstractController后，使用模板命名空间引用Bundle内的Twig文件：

namespace BundleTest\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;

class TestController extends AbstractController
{
    public function index(): Response
    {
        return $this->render('@BundleTest/test_bundle.html.twig');
    }
}

5. 验证配置 #

• 清除缓存：执行php bin/console cache:clear
• 检查路由：执行php bin/console debug:router，确认bundle_test_route已存在
• 访问http://你的域名/routeInBundle，验证模板是否正常加载

内容的提问来源于stack exchange，提问作者Tarkan Antoan Başar