必须让环境、适配器、池定义、HTTP头和验证手段全部对齐,否则缓存会静默降级为文件存储或完全不命中;需确认APP_ENV=prod且APP_DEBUG=false已生效,配置cache.adapter.redis_tag_aware适配器并绑定default_redis_provider,设置HTTP缓存头与ESI局部缓存,最后通过debug:container和redis-cli验证。

在 Symfony 6.4 中创建缓存策略不是只改一个配置就能生效的事——必须让环境、适配器、池定义、HTTP 头和验证手段全部对齐,否则缓存会静默降级为文件存储或完全不命中。
确认生产环境已就绪
执行 php bin/console debug:container --env=prod | grep debug,输出中必须不含 debug: true;若存在,说明 【APP_ENV=prod 和 APP_DEBUG=false 必须同时写在 .env 文件中,且未被 .env.local 覆盖】。
运行 php bin/console cache:clear --env=prod && php bin/console cache:warmup --env=prod。跳过 warmup 会导致首次请求触发即时编译,响应延迟飙升数倍,这不是缓存没生效,而是容器根本没预热。
配置 Redis 缓存适配器
方法一:基础 Redis 连接(适用于单节点、无标签需求场景)
编辑 config/packages/cache.yaml:
framework:
cache:
default_redis_provider: 'redis://127.0.0.1:6379'
pools:
cache.app:
adapter: cache.adapter.redis
provider: ~
方法二:标签感知型适配器(推荐,支持按业务维度批量清除)
将 adapter 改为 【cache.adapter.redis_tag_aware】,其他不变。注意:该适配器名必须全小写+下划线,写成 redis-tag-aware 或 redisTagAware 会直接报 ServiceNotFoundException。
方法三:环境变量驱动(上线前必须做)
在 .env 中添加:CACHE_ADAPTER=redis_tag_awareREDIS_DSN=redis://default:mysecret@10.0.1.5:6379/0
再在 YAML 中引用:default_redis_provider: '%env(REDIS_DSN)%'app: 'cache.adapter.%env(CACHE_ADAPTER)%'
绑定缓存池并验证连接
第一步:确认 Redis 服务可用。
执行 redis-cli -h 127.0.0.1 -p 6379 ping,返回 PONG 才表示端口通、认证通过。
第二步:检查 DSN 是否被正确加载。
运行 php bin/console debug:container --parameter=default_redis_provider --env=prod,输出必须是你配置的完整 DSN 字符串。
第三步:验证缓存池是否使用 Redis。
执行 php bin/console debug:container cache.app --env=prod,查看 class 字段是否含 RedisAdapter 或 TagAwareAdapter。如果看到 PhpFilesAdapter,说明 provider 没绑定成功或适配器名拼错。
第四步:强制触发一次写入并检查 Redis。
在控制器中插入:$cache = $this->get('cache.app');$cache->set('test_key', 'hello_redis', 30);
然后执行 redis-cli keys "test_key*",应能查到键值。
设置 HTTP 缓存头与局部缓存
在控制器返回 Response 前添加:$response->setPublic();$response->setMaxAge(600);$response->setSharedMaxAge(1200);
不设 setPublic() 会导致 private 头,CDN 和反向代理将拒绝缓存。
对页面中静态片段(如页脚、菜单)启用 ESI:
再为 /esi/footer 路由单独设置更长 max-age,实现局部复用。
使用 @Cache 注解快速配置(需安装 symfony/http-kernel):/** * @Cache(maxage="300", smaxage="600", public=true) */











