Symfony启动session_start()反序列化LazyUuidFromString报错修复

问题核心原因 #

该报错是三层逻辑叠加触发的：

1. 你项目依赖的ramsey/uuid库升级到4.x版本后，新增了Ramsey\Uuid\Lazy\LazyUuidFromString懒加载类，类结构与旧版本不兼容
2. 本地PHP原生Session存储目录中，残留了之前版本项目写入的、包含旧Uuid序列化数据的sess_*临时文件
3. 调用session_start()反序列化旧数据时，PHP 7.4抛出格式不匹配的Warning，而Symfony默认开启严格错误处理，会将Warning直接转为未捕获的ErrorException，中断页面加载

分步修复操作 #

1. 快速解决（立即可用） #

开发环境的Session数据无保留价值，直接清空旧Session文件即可：

• 执行命令获取当前PHP的Session存储路径：
  php -r "echo session_save_path();"
• 打开上述路径，删除所有文件名以sess_开头的临时文件
• 重启Symfony本地服务后，session_start()即可正常运行，报错消失

2. 根治同类问题（避免后续复现，二选一） #

方案A：锁定兼容性的Uuid依赖版本

执行Composer命令，将ramsey/uuid降级到与Symfony 4.3兼容的3.x版本，避免自动升级带来的结构变动：
composer require ramsey/uuid:^3.9

方案B：调整Session序列化规则

打开项目的config/packages/framework.yaml，在session配置块中新增serialize_handler配置，提升反序列化兼容性：

framework:
    session:
        # 保留原有session配置项
        serialize_handler: 'php_serialize'

默认的php序列化格式对类结构变动的容错性较差，改为php_serialize后可大幅降低同类反序列化报错概率。

3. 验证Session可用性 #

重启Symfony服务后，可通过在控制器中执行以下代码确认Session功能正常：

$session->set('test_key', 'test_value');
var_dump($session->get('test_key'));

能正常输出值即代表Session功能已恢复。

注意：不要注释NativeSessionStorage.php中的session_start()代码，会导致依赖Session的登录、表单令牌、缓存等核心功能异常。

内容的提问来源于stack exchange，提问作者Ryan Douglas