Symfony创建项目报错需按顺序排查：一查PHP版本与DOM等核心扩展是否就位；二验Composer平台配置与依赖约束兼容性；三确保存储目录var/cache和var/log权限正确；四核对.env.local存在性及APP_ENV/APP_SECRET是否生效。
Symfony创建项目报错，通常不是单一原因，而是环境、配置、权限或依赖多个环节卡点叠加的结果。直接看错误信息容易误判，需按固定顺序逐层验证。
检查PHP版本与核心扩展是否就位
创建项目前必须确认基础运行环境达标。Symfony 6.4要求PHP ≥8.1，7.x要求8.2，8.0起要求8.3——用php -v核对版本，不匹配会直接中断composer create-project。
- 运行
php -m | grep -E "dom|xml|mbstring|json|ctype|filter"，缺任一模块（尤其是dom和xml）会导致项目初始化失败且无明确提示 - Ubuntu/Debian下缺DOM扩展：执行
sudo apt install php-xml，然后sudo systemctl restart php*-fpm - macOS用Homebrew安装PHP时，需检查
php.ini中extension=dom是否启用，且extension_dir路径正确
验证Composer与平台配置兼容性
Composer解析依赖失败是创建阶段最常见报错来源，典型提示是“Your requirements could not be resolved”。这往往不是包本身问题，而是约束冲突或环境声明缺失。
- 在
composer.json的config.platform里显式声明PHP版本，例如："php": "8.2.0"，避免本地PHP版本与目标包要求错位 - 避免在
require中写死严格版本如"symfony/framework-bundle": "6.4.0"，改用"^6.4"留出升级空间 - 执行
composer create-project symfony/skeleton my_project --no-interaction时加--verbose，可看到具体卡在哪一个包的版本协商上
确认缓存与日志目录权限是否正常
即使项目结构生成成功，首次运行php bin/console或访问public/index.php也可能500，根源常在var/cache和var/log不可写。
- 创建项目后立即执行：
mkdir -p var/cache var/log && chmod -R 775 var/cache var/log（Linux/macOS） - 确保Web服务器用户（如
www-data或_www）对这两个目录有读写权限，否则缓存无法生成，日志无法记录，错误静默丢失 - 若用Docker，需在
Dockerfile中显式chown -R www-data:www-data /var/www/html/var
排查环境变量与配置加载链路
新项目启动失败，90%和.env.local或APP_ENV有关。Symfony 4.4+不再从parameters.yml读取，全靠Dotenv驱动。
- 检查根目录是否存在
.env.local，若只有.env.local.example，复制并编辑：cp .env.local.example .env.local - 确认
APP_ENV=dev和APP_SECRET=xxx已填写，空值或注释掉会导致RuntimeException直接中断 - 测试变量是否生效：
php -r "echo $_ENV['APP_ENV'] ?: 'MISSING';"，输出dev才算加载成功
