Symfony 4.4 var/cache/prod/pools无限增长原因及规避方案

云原生阿岚

2026-8-29

问题成因

你看到的持续增长的缓存文件来自Doctrine ORM默认开启的三类缓存中的查询结果缓存：

Symfony 4.4生产环境下Doctrine Bundle的默认配置，会将元数据缓存、DQL查询转换缓存、查询结果缓存全部存储到文件系统缓存池，路径就是var/cache/prod/pools下的哈希命名目录。
元数据、DQL转换缓存的内容是固定的实体映射、DQL转SQL的规则，不会重复生成，总量通常只有几MB。
无限增长的文件全部来自查询结果缓存：你的定时任务里包含带动态时间参数的查询（比如你查到的带2022-06-13 23:21:52这类秒级时间参数的SQL），每次查询参数变化都会生成全新的缓存key，旧缓存永远无法被命中复用，只会持续堆积，最终出现单天缓存涨到近200M、碎文件过多拖慢文件系统的问题。

解决方案

按优先级从高到低选择以下方案即可，不需要额外安装内存缓存服务：

方案1：直接关闭无意义的查询结果缓存
低流量站点+带动态参数的查询场景下，查询结果缓存几乎没有命中率，反而会产生大量垃圾文件，直接关闭即可。修改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: none
```
保留的元数据、DQL查询缓存为固定内容，不会无限增长，不影响Doctrine运行性能。
方案2：若需要保留结果缓存，配置自动过期清理
如果部分高频固定查询确实需要结果缓存，可通过配置限制缓存生命周期+定期清理过期文件，避免无限堆积。
首先修改config/packages/cache.yaml，给结果缓存池设置过期时间：
```
framework:
    cache:
        pools:
            doctrine.result_cache_pool:
                adapter: cache.adapter.filesystem
                default_lifetime: 3600 # 缓存最长保留1小时
```
然后在你现有的每小时运行的定时任务最前面，加一行缓存清理命令：
```
php bin/console cache:pool:prune --env=prod
```
该命令只会删除已过期的缓存文件，不会影响正在使用的有效缓存，执行速度远快于全量清空缓存。
方案3：替换文件缓存存储介质，解决碎文件问题
哪怕没有APCu、memcached等内存缓存服务，也可以用SQLite存储缓存，从根源避免大量散碎小文件拖慢文件系统：
1. 先安装所需依赖：
```
composer require symfony/cache-adapter-pdo
```
1. 修改config/packages/cache.yaml，将默认缓存适配器改为PDO SQLite驱动：
```
framework:
    cache:
        app: cache.adapter.pdo
        system: cache.adapter.pdo
        default_pdo_provider: 'pdo_sqlite:%kernel.cache_dir%/cache.sqlite'
```
所有缓存会集中存储到单个SQLite文件中，不会生成数十万级别的碎文件，部署时清理缓存仅需删除单个文件，速度比遍历删除散碎文件快数十倍。

注意：所有配置修改完成后，需要执行php bin/console cache:clear --env=prod清理旧缓存后生效。

内容的提问来源于stack exchange，提问作者A.L