必须显式启用redis session handler，否则symfony默认使用文件存储会话；需安装php-redis扩展、配置framework.session.handler_id为'session.handler.redis'、设置cache_prefix避免键冲突。
必须显式启用 Redis Session Handler，否则即使 PHP 能连 Redis，Symfony 仍默认用文件存会话。
phpRedis 扩展没装好，session_start() 直接报错
最常见现象是调用 session_start() 时抛出 Failed to initialize storage module。根本原因不是 Symfony 配置问题，而是 PHP 层压根没加载 redis 模块。
- 运行
php -m | grep redis，无输出就说明扩展未启用 - Ubuntu/Debian：装
php-redis（注意匹配当前 PHP 版本，如php8.2-redis） - CentOS/RHEL：用
php-pecl-redis，确认extension=redis.so在生效的php.ini里且未被注释 - Docker 环境：Dockerfile 中需含
docker-php-ext-install redis，且不能只在构建阶段装、运行时容器里缺失 - 装完务必重启
php-fpm或apache2，否则配置不生效
framework.session.handler_id 必须设为 session.handler.redis
Symfony 不会自动把 Redis 当作会话后端——哪怕你已配了 default_redis_provider。它只负责缓存，和会话存储是两套机制。
- Symfony 5.4+ 必须在
config/packages/framework.yaml显式写：framework: session: handler_id: 'session.handler.redis' - 若用旧版（如 Symfony 4），还需手动定义服务：
Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler，并传入Predis\Client或Redis实例 - DSN 格式要严格：必须是
redis://127.0.0.1:6379?database=1，不能漏redis://前缀；端口不能加引号（YAML 里写成"6379"会导致部分版本静默解析失败） - 验证是否生效：在控制器里
var_dump($this->get('session')->getHandler())，应返回RedisSessionHandler实例，而非NativeFileSessionHandler
多个环境共用 Redis 库，必须加 cache_prefix
上线后用户频繁登出、购物车清空，大概率是 dev/test/prod 共用同一个 Redis database，key 冲突或被误删。
- 强制设置前缀：
framework.session.storage.options.cache_prefix: 'sess_%kernel.environment%_' - 如果 Redis 配了密码，
session.save_path不能只写tcp://...，得用完整 DSN：redis://user:pass@127.0.0.1:6379?database=0 - 别依赖
session.save_handler = redis这种 php.ini 全局配置——它绕过 Symfony 生命周期，无法注入自定义前缀或 TTL，也难统一管理 - TTL 默认由
framework.session.cookie_lifetime和gc_maxlifetime共同控制，但 Redis 侧不会自动同步过期；建议显式设framework.session.storage.options.ttl（单位秒）确保 Redis key 真实过期
真正容易被忽略的是：Redis 会话键名不带业务上下文，一旦跨项目或跨团队共享 Redis 实例，光靠 database 隔离远远不够——cache_prefix 是唯一可靠手段，且必须包含环境标识。
