Pimcore 6.9迁移至10.6后管理界面路由异常及Bundle结构咨询

一、管理界面路由问题 #

针对已按Symfony Flex文档修改路由仍报错的情况，可按以下步骤排查修复：

• 确认config/routes/pimcore_admin.yaml配置是否符合Pimcore 10.x要求，正确配置应为：

  pimcore_admin:
      resource: "@PimcoreAdminBundle/Resources/config/routing.yml"
      prefix: /admin
  

• 检查.env中的APP_ENV，若为开发环境，执行bin/console cache:clear --env=dev清除缓存；生产环境执行bin/console cache:clear --env=prod并确保权限正确
• 验证Web服务器（如Nginx）配置，确保/admin路径的请求全部转发到public/index.php，避免静态资源路由冲突
• 删除旧版本遗留的路由配置文件（如app/config/routing.yml），确保新配置完全生效

二、自定义Bundle组织方式 #

• 原src/AppBundle/移至src/目录是符合Symfony Flex规范的正确操作
• 其他自定义Bundle（如bundleName1、bundleName2）有两种可行方案：
  1. 放在src/目录下，例如src/BundleName1Bundle/，与AppBundle保持同层级，需在config/bundles.php中完成注册
  2. 可移至项目根目录下的独立文件夹（如bundles/bundleName1/），但需在composer.json中添加自动加载规则：

     "autoload": {
         "psr-4": {
             "BundleName1\\": "bundles/bundleName1/src/"
         }
     }
     

     执行composer dump-autoload更新自动加载规则后，在config/bundles.php中注册该Bundle
• 注意：无论采用哪种方式，Bundle的命名空间必须与目录结构严格对应，确保PSR-4自动加载机制正常工作

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