Symfony 2.3无法生成bootstrap.php.cache，报ParameterBag命名冲突

问题背景 #

访问app_dev.php或执行Symfony控制台命令时，触发致命错误：

Fatal error: Cannot use Symfony\Component\DependencyInjection\ParameterBag\ParameterBag as ParameterBag because the name is already in use in /myPath/app/bootstrap.php.cache on line 1958

已尝试的无效操作：

• 无法执行cache:clear命令（错误本身导致命令无法启动）
• 固定sensio/distribution-bundle为3.0.36版本并降级Composer至2.2，执行composer install/update后问题未解决
• 手动处理bootstrap文件后触发新错误：Fatal error: Uncaught Error: Class "Symfony\Component\HttpKernel\Kernel" not found in...

修复步骤 #

1. 彻底清理残留文件 #

先手动删除所有缓存和自动生成的文件，确保环境干净：

# 删除缓存目录
rm -rf app/cache/*
# 删除bootstrap缓存文件
rm app/bootstrap.php.cache
# 可选：删除vendor目录，确保依赖完全重新安装
rm -rf vendor/

2. 重新安装兼容依赖 #

确保Composer版本与Symfony 2.3完全适配，执行以下命令：

# 锁定Composer到2.2.x稳定版（Symfony 2.3的兼容上限）
composer self-update 2.2.24
# 安装依赖时跳过自动执行的脚本，避免提前触发错误
composer install --no-scripts

3. 手动生成bootstrap文件 #

依赖安装完成后，单独执行bootstrap生成命令：

php vendor/sensio/distribution-bundle/Sensio/Bundle/DistributionBundle/Resources/bin/build_bootstrap.php app/

4. 临时修复命名冲突 #

如果生成后仍出现原错误，直接编辑app/bootstrap.php.cache：
找到第1958行附近的use语句，将别名修改为不重复的名称，比如：

// 原代码
use Symfony\Component\DependencyInjection\ParameterBag\ParameterBag as ParameterBag;
// 修改为
use Symfony\Component\DependencyInjection\ParameterBag\ParameterBag as DIParameterBag;

同时将代码块内所有使用ParameterBag别名的地方替换为DIParameterBag（该范围通常很小，仅在当前函数或类内）。

5. 验证恢复情况 #

完成后测试应用状态：

php app/console --version

若能正常输出Symfony版本，说明应用已恢复运行。

后续迁移建议 #

应用恢复后，尽快启动版本升级流程：

• 先升级到Symfony 2.8（LTS版本），再逐步向更高版本迁移
• 替换过时依赖，比如friendsofsymfony/user-bundle的旧alpha版本，改用对应Symfony版本的稳定包
• 逐步将psr-0自动加载规则改为psr-4，符合现代PHP规范

内容的提问来源于stack exchange，提问作者Matt Welander