Doctrine 查询缓存需先启用二级缓存与查询/结果缓存组合，仅对DQL生效；高频低变计算型查询才值得缓存；应用层复杂逻辑应使用Symfony Cache组件配合TagAwareAdapter批量失效，避免缓存实体实例。
缓存 Doctrine 查询结果前先确认是否真有必要
直接缓存 find() 或 findAll() 的结果往往事倍功半——Doctrine 本身已有二级缓存（2LC）和查询缓存（Query Cache），但默认关闭，且只对 DQL/QueryBuilder 生效，对原生 SQL 或简单主键查找无效。真正高频、低变更、计算开销大的查询才值得加缓存，比如聚合统计、树形结构遍历、跨表关联结果集。
用 Doctrine 的 Query Cache + Result Cache 组合最省事
启用后，同一 DQL 在参数不变时，Doctrine 会跳过 SQL 解析和执行，直接从缓存取结果。注意：必须同时启用两种缓存，缺一不可。
- 在
config/packages/doctrine.yaml中开启：doctrine: orm: second_level_cache: enabled: true region_cache_driver: type: pool pool: doctrine.result_cache_pool query_cache_driver: type: pool pool: doctrine.query_cache_pool result_cache_driver: type: pool pool: doctrine.result_cache_pool - 在实体类上标注
@ORM\Cache（启用 2LC）或仅对特定查询手动启用：$qb = $em->createQueryBuilder(); $qb->select('u')->from(User::class, 'u')->where('u.status = :status'); $query = $qb->getQuery()->useResultCache(true, 3600, 'users_active'); - 缓存键由 DQL + 参数哈希生成，所以
setParameter('status', 1)和setParameter('status', '1')会产生不同缓存项——类型不一致会导致缓存击穿
用 Symfony Cache 组件缓存复杂业务逻辑结果
当查询涉及多个 Repository 调用、外部 API 或模板渲染逻辑时，Doctrine 缓存无能为力，此时应退到应用层缓存。推荐用 cache.app 池（默认基于 FilesystemAdapter 或 Redis）。
- 注入
CacheInterface（别用CacheItemPoolInterface，它绕过 Symfony 的命名空间隔离）：public function getDashboardStats(CacheInterface $cache): array { $key = 'dashboard_stats_'.date('Y-m-d'); $item = $cache->get($key, function (CacheItemInterface $item) { $item->expiresAfter(3600); return $this->calculateExpensiveStats(); // 多次 DB 查询 + 计算 }); return $item; } - 避免缓存对象实例（如
User实体），序列化可能触发懒加载或循环引用；只缓存数组、标量或 DTO - 使用
TagAwareAdapter可批量失效（例如用户更新后清除所有含user_123tag 的缓存），但要注意 tag 存储开销——Redis 中每个 tag 对应一个 SET，大量 tag 会撑大内存
缓存失效比缓存写入更难设计
自动缓存（如 Query Cache）靠 SQL 变更自动失效，但应用层缓存必须显式管理。常见错误是“只增不删”或“删错范围”。
- 实体变更时，不要只清空单个缓存项，优先用 tag：
$cache->invalidateTags(['user_'.$userId, 'dashboard']);
- 避免在
PostPersist等生命周期回调里调用缓存服务——事务未提交，缓存提前失效可能导致脏读 - 对分页列表类缓存（如
products_page_2），与其逐个清理，不如用统一 tag（如products_list）并在产品增删时批量失效 - 本地开发用
FilesystemAdapter时，注意文件权限和并发写入冲突；生产务必切到 Redis 或 APCu
缓存不是开关，而是数据一致性与响应速度之间的精细权衡。最常被忽略的是缓存粒度——缓存整页不如缓存组件，缓存组件不如缓存数据片段，而片段的边界往往藏在业务语义里，不在 SQL 里。
