Symfony 5.4项目Doctrine查询与结果缓存配置循环引用错误求助

这个循环引用问题的根源在于你手动在services段重复定义了Doctrine缓存池服务，而Symfony已经通过framework.cache.pools帮你自动处理了这些服务的创建和适配，手动定义反而导致了依赖循环。

问题分析 #

你在services里定义的doctrine.system_cache_pool和doctrine.result_cache_pool，参数分别指向了doctrine.orm.default_result_cache和doctrine.orm.default_metadata_cache——但这两个默认服务本身又依赖于你在framework.cache.pools里配置的池，形成了闭环引用：
doctrine.result_cache_pool → doctrine.orm.default_metadata_cache → doctrine.system_cache_pool → doctrine.orm.default_result_cache → doctrine.result_cache_pool

开发环境没报错是因为默认缓存使用的是array驱动，不会触发完整的服务依赖链检查，而生产环境启用了实际的缓存适配器（比如文件或Redis），依赖关系被严格校验，循环引用就暴露了。

解决方案 #

直接移除services段的手动定义，让Symfony自动管理Doctrine缓存池的适配。修正后的config/packages/prod/doctrine.yaml应该是这样：

doctrine:
  orm:
    metadata_cache_driver:
      type: pool
      pool: doctrine.system_cache_pool
    query_cache_driver:
      type: pool
      pool: doctrine.system_cache_pool
    result_cache_driver:
      type: pool
      pool: doctrine.result_cache_pool

framework:
  cache:
    pools:
      doctrine.result_cache_pool:
        adapter: cache.app
      doctrine.system_cache_pool:
        adapter: cache.system

为什么这样生效？ #

Symfony与Doctrine的集成已经帮你处理了PSR-6缓存池到Doctrine缓存接口的适配：当你给Doctrine的cache driver指定type: pool和对应的pool名称时，Symfony会自动找到framework.cache.pools中定义的服务，并且自动包装成Doctrine所需的DoctrineProvider实例，不需要你手动配置这部分。

移除手动定义的服务后，依赖链变得清晰：

• Doctrine的元数据/查询缓存使用doctrine.system_cache_pool（适配自cache.system适配器）
• 结果缓存使用doctrine.result_cache_pool（适配自cache.app适配器）
  完全没有循环引用的问题。

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