Doctrine二级缓存必须显式启用，配置中需设置second_level_cache: enabled: true并指定region_cache_driver，实体类需添加@ORM\Cache注解且合理选择usage策略，DQL查询须手动启用useResultCache()，多区域缓存需自定义池并精确映射区域名。
Doctrine二级缓存必须显式启用，否则不生效
Doctrine默认完全关闭二级缓存，哪怕你配了Redis、写了@ORM\Cache注解，没在配置里打开开关，它就当不存在。这是最常被忽略的第一步。
在config/packages/doctrine.yaml中，必须明确设置second_level_cache: enabled: true，且要指定region_cache_driver——它不是可选的“优化项”，而是强制要求的底层驱动配置：
doctrine:
orm:
second_level_cache:
enabled: true
region_cache_driver:
type: pool
pool: doctrine.system_cache_pool
注意：pool指向的必须是已定义的缓存池（如doctrine.system_cache_pool），不能随便写个名字；这个池还要在framework.cache.pools下正确定义，否则启动会报Cache pool "xxx" does not exist错误。
实体类加@ORM\Cache不是打个标签就完事
@ORM\Cache注解只声明缓存策略，但具体行为取决于实体关系和字段类型。它不缓存关联对象本身，只缓存当前实体的标量字段+主键。
-
usage = "READ_ONLY"：适合国家、税率等几乎不变的数据，允许 Doctrine 跳过版本检查，性能最好 -
usage = "NONSTRICT_READ_WRITE"：适合VatRate这类变化极少但需保证最终一致性的数据；更新时不会同步失效关联缓存，靠 TTL 自然过期 -
usage = "READ_WRITE"：需要事务级强一致性，但 Doctrine 会写入额外的锁键，高并发下易争用，慎用
常见错误：给带@ORM\OneToMany的集合属性加@ORM\Cache，这无效——集合本身不进二级缓存，得靠关联目标实体（如VatRate）自己开启缓存，并在查询时显式join或使用fetch="EAGER"才能命中。
查询结果缓存和二级缓存是两套机制，别混用
很多人以为开了二级缓存，$em->find()和DQL查询就自动缓存了，其实不是：
-
$em->find()走的是二级缓存（前提是实体类有@ORM\Cache） - DQL查询（包括
createQuery()、findBy()等）默认不走二级缓存，必须手动调useResultCache(true)或配置result_cache_driver -
query_cache_driver缓存的是SQL解析后的AST和执行计划，result_cache_driver才缓存查询结果集
所以，如果你发现$em->find(Country::class, 1)能命中缓存，但$em->getRepository(Country::class)->findBy(['active' => true])每次都查库，不是配置漏了，而是后者根本没启用结果缓存。正确做法是在查询构建时加链式调用：->useResultCache(true, 3600, 'country_active_list')。
多区域缓存不是开箱即用，得手动配池+映射
想把Country缓存在本地Redis、VatRate缓存在远程ElastiCache？Doctrine二级缓存本身不支持“按实体分池”，必须靠“区域（region）”抽象 + 自定义缓存池绑定来实现。
步骤是三步：
- 在
framework.cache.pools下定义两个独立池，比如cache.country_pool（连本地Redis）和cache.vatrate_pool（连远程Redis） - 在
doctrine.orm.second_level_cache.regions里为每个实体指定区域名，并将该区域映射到对应池：country_region: pool: cache.country_pool - 在实体类上用
@ORM\Cache(region="country_region")显式绑定
漏掉任何一步，都会回退到默认池。而且要注意：区域名必须全项目唯一，不能重复；池名必须和framework.cache.pools里声明的一致，大小写敏感。
enabled: true、实体有@ORM\Cache且usage合理、关联查询或集合加载方式匹配缓存粒度。最容易被绕过的其实是“区域映射”那层——它不报错，但缓存会静默写进默认池，导致你以为分池成功了，实际还是挤在同一个Redis实例里。 
