composer 不负责加载 bundles，只安装代码并触发 flex；真正加载由 symfony kernel 和 bundles.php 配置机制完成。bundle 未注册常因 flex 未启用、composer.json 缺"type": "symfony-bundle"、psr-4 映射错误或环境不匹配导致。
Composer 不负责加载 Bundles，它只安装代码和触发 Flex；真正加载 Bundle 的是 Symfony 自身的 Kernel 和 Bundles 配置机制。 这个认知偏差导致很多人在调试 Bundle 未生效时，反复重装 Composer 包却找不到问题根源。
composer require 后 Bundle 为什么没注册？
因为 composer require 本身不修改 config/bundles.php，也不调用 Symfony 的 Bundle 注册逻辑——除非你装的是支持 Symfony Flex 的包（如 symfony/mailer），且项目已启用 Flex 插件。
- Flex 启用后，
composer require会拦截事件、拉取 recipe、自动写入config/bundles.php并生成配置文件；没启用 Flex 就纯靠手动注册 - Symfony 4.4+ 默认启用 Flex，但老项目或手动创建的 skeleton 可能没装
symfony/flex，此时composer require只是把代码下到vendor/，Bundle 不会自动激活 - 检查是否启用 Flex：
composer show | grep flex；若无输出，先运行composer require symfony/flex
Bundle 注册后仍不生效的常见断点
注册 ≠ 加载。Symfony 在 Kernel::registerBundles() 中读取 config/bundles.php 返回数组，再实例化每个 Bundle 类；任何环节出错都会静默失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
config/bundles.php中类名拼错（如OldSoundRabbitMqBundleOldSoundRabbitMqBundle::class少了个Mq）→ 实例化失败，但不会报错，Bundle 被跳过 - Bundle 类构造函数抛异常（比如依赖未定义的服务）→
registerBundles()中 catch 后静默忽略，日志里可能只有Warning: include(): Failed opening ... - 环境不匹配：Bundle 注册时指定了环境条件（如
['dev' => true]），但在 prod 环境运行 → 不加载 - Bundle 类不存在或命名空间与 PSR-4 映射不一致 →
autoload_classmap.php或autoload_static.php没该类，new $class失败
Flex recipe 没执行？查这三处
Flex 不是魔法，它依赖 composer.json 的 "type": "symfony-bundle"、recipe 仓库的匹配规则、以及本地插件状态。recipe 失效往往不是命令问题，而是上下文缺失。
- 运行
composer require vendor/package后，检查flex.symfony.com是否返回 200 —— 国内网络可能超时或被拦截，导致 recipe 下载失败（无提示） - 查看
composer.lock中该包条目是否有"recipe"字段；没有说明 Flex 未识别该包为可 recipe 包 - recipe 执行后应生成文件（如
config/packages/package.yaml），若没生成，说明 recipe 内容为空或被跳过（例如包版本不匹配 recipe 规则） - 临时禁用 Flex 测试：
COMPOSER_NO_PLUGINS=1 composer require vendor/package，对比有无 Flex 时的输出差异
手动加载 Bundle 时 autoload 怎么配才不冲突？
Bundle 自身的 autoload 配置（composer.json 中的 psr-4 或 classmap）必须与 Symfony 的加载路径严格对齐，否则 Kernel 找不到 Bundle 类，或类被重复加载引发 fatal error。
- Bundle 的
composer.json应声明"autoload": {"psr-4": {"OldSound\RabbitMqBundle\": "src/"}}，且实际目录结构为src/OldSound/RabbitMqBundle/RabbitMqBundle.php - 不要在主项目
composer.json中为 Bundle 目录加额外psr-4映射——这会导致同一类被两个 autoloader 加载，PHP 报Fatal error: Cannot declare class ... because the name is already in use - 若 Bundle 使用
filesautoload（如全局 helper 函数），确保它不依赖 Symfony 容器或未初始化的服务，否则在 Kernel 初始化前就执行会失败
真正卡住人的从来不是命令怎么敲，而是不知道哪一层机制在静默接管或拒绝执行——Flex、Kernel、ClassLoader、Opcache，四层叠加下来，一个配置项错位就能让 Bundle “存在但不可见”。
