使用PhpFileLoader通过Bundle语法加载资源失败问题排查

你遇到的核心问题是自己实例化的PhpFileLoader缺少能解析@BundleName路径的文件定位器配置。在routing.php里的$loader是Symfony框架预先配置好的，它自带了支持bundle路径解析的定位器；而你在BundleLoader里新建的PhpFileLoader用的是基础版Symfony\Component\Config\FileLocator，这个定位器完全不知道如何把@CompanyVendorXXXBundle转换成实际的文件系统路径。

具体修复方案 #

方案1：替换为HttpKernel专用的FileLocator #

Symfony提供了Symfony\Component\HttpKernel\Config\FileLocator，它专门用于解析bundle路径，需要依赖Kernel实例来获取bundle的路径信息。修改你的BundleLoader构造函数：

namespace Mapbender\CoreBundle\Routing;

use Symfony\Component\Config\Exception\FileLoaderImportCircularReferenceException;
use Symfony\Component\Config\Exception\FileLoaderLoadException;
use Symfony\Component\HttpKernel\Config\FileLocator; // 替换为这个类
use Symfony\Component\Routing\Loader\PhpFileLoader;
use Symfony\Component\Routing\RouteCollection;

class BundleLoader {
    protected $container;
    protected $path = "/Controller/";
    protected $loader;

    /**
     * BundleLoader constructor.
     *
     * @param $container
     */
    public function __construct($container) {
        $this->container = $container;
        $kernel = $this->container->get('kernel');
        // 传入Kernel实例，让FileLocator能解析@Bundle格式的路径
        $this->loader = new PhpFileLoader(new FileLocator($kernel));
    }

    /**
     * @param $resource
     * @param null $type
     * @return RouteCollection
     */
    public function load($resource, $type = null) {
        $routes = new RouteCollection();
        $bundles = $this->container->getParameter('kernel.bundles');

        foreach ($bundles as $bundleName => $bundlePath) {
            if (preg_match('/CompanyVendor/', $bundleName, $matches)) {
                $routingConfigPath = "@" . $bundleName. $this->path;
                try {
                    // 补充注解路由的类型参数，和routing.php保持一致
                    $routes->addCollection(
                        $this->loader->import($routingConfigPath, "annotation")
                    );
                } catch (FileLoaderImportCircularReferenceException $e) {
                    throw $e;
                } catch (FileLoaderLoadException $e) {
                    throw $e;
                }
            }
        }
        return $routes;
    }
}

方案2：直接注入框架的路由加载器（更推荐） #

不要自己创建PhpFileLoader，让Symfony的依赖注入容器把已经配置好的routing.loader服务注入进来——这个加载器自带所有必要的路径解析能力和驱动支持。

首先修改你的服务配置（比如services.yaml）：

Mapbender\CoreBundle\Routing\BundleLoader:
    arguments:
        - '@service_container'
        - '@routing.loader' # 注入框架预设的路由加载器

然后更新BundleLoader的代码：

namespace Mapbender\CoreBundle\Routing;

use Symfony\Component\Config\Exception\FileLoaderImportCircularReferenceException;
use Symfony\Component\Config\Exception\FileLoaderLoadException;
use Symfony\Component\Routing\Loader\LoaderInterface; // 引入LoaderInterface
use Symfony\Component\Routing\RouteCollection;

class BundleLoader {
    protected $container;
    protected $path = "/Controller/";
    protected $loader;

    /**
     * BundleLoader constructor.
     *
     * @param $container
     * @param LoaderInterface $loader
     */
    public function __construct($container, LoaderInterface $loader) {
        $this->container = $container;
        $this->loader = $loader; // 使用注入的框架加载器
    }

    /**
     * @param $resource
     * @param null $type
     * @return RouteCollection
     */
    public function load($resource, $type = null) {
        $routes = new RouteCollection();
        $bundles = $this->container->getParameter('kernel.bundles');

        foreach ($bundles as $bundleName => $bundlePath) {
            if (preg_match('/CompanyVendor/', $bundleName, $matches)) {
                $routingConfigPath = "@" . $bundleName. $this->path;
                try {
                    $routes->addCollection(
                        $this->loader->import($routingConfigPath, "annotation")
                    );
                } catch (FileLoaderImportCircularReferenceException $e) {
                    throw $e;
                } catch (FileLoaderLoadException $e) {
                    throw $e;
                }
            }
        }
        return $routes;
    }
}

为什么硬编码在routing.php里能正常工作？ #

因为routing.php里的$loader是Symfony在路由加载流程中自动传入的，它已经被框架配置好了所有必要的依赖——包括能解析bundle路径的定位器、支持注解路由的驱动等。而你自己新建的PhpFileLoader是“裸”的，没有这些关键配置，自然找不到对应的Bundle路径。

内容的提问来源于stack exchange，提问作者David P.