Symfony 7.4.21 新手报错主要集中在环境（PHP≥8.2且需intl等12个扩展）、依赖（Composer镜像源、缓存、包选择）和启动（php -S -t public、缓存清理、.env配置）三环节，按序排查可解决90%问题。
搭建 Symfony 7.4.21 应用时，新手最常遇到的报错基本集中在环境、依赖和启动三个环节。只要按顺序排查 PHP 版本与扩展、Composer 锁定逻辑、服务启动路径这三关，90% 的问题都能当场解决。
PHP 环境不达标：版本低或扩展缺失
Symfony 7.4.21 强制要求 PHP ≥ 8.2，且必须启用 intl、mbstring、opcache 等至少 12 个扩展。常见现象包括：
- 运行 composer create-project 报错 “Your requirements could not be resolved”，实际是 PHP 版本太低
- php -v 显示 8.1.x 或更低 → 必须升级到 8.2+（Ubuntu/Debian 推荐添加 ondrej/php PPA 后重装）
- 页面空白或 500 错误，php -m | grep intl 无输出 → 缺少 intl 扩展，需执行 sudo phpenmod -v 8.2 intl 并重启 PHP-FPM 或 Apache
- 错误提示 “Class ‘IntlDateFormatter’ not found” → 不只是 intl 扩展未启，还可能是系统缺少 libicu-dev（Ubuntu/Debian 下运行 sudo apt install libicu-dev，再重装 php8.2-intl）
Composer 创建失败：版本解析或网络问题
使用 composer create-project symfony/skeleton:^7.4.21 时，报 “Could not find package” 或超时，通常不是命令写错，而是：
- 本地 Composer 镜像源过旧，无法识别 ^7.4.21 这类语义化版本约束 → 临时切回官方源：composer config -g repo.packagist composer https://packagist.org
- 网络不稳定导致部分包下载中断 → 先清缓存：composer clear-cache，再加 -vvv 参数重试，观察卡在哪一个包
- 误用了 symfony/skeleton（纯骨架，无 WebProfiler、Twig、MakerBundle）→ 新手建议改用 symfony/website-skeleton，一步到位
- 项目目录已有同名文件夹或权限不足 → 换个干净路径，确保当前用户对目标目录有读写权
启动后打不开欢迎页：入口或配置错误
项目创建成功但浏览器访问 http://127.0.0.1:8000 显示 404、500 或直接拒绝连接，重点检查：
- 启动命令写成 php -S 127.0.0.1:8000 public/index.php → 错！必须用 -t public 指定文档根目录，正确命令是：php -S 127.0.0.1:8000 -t public
- 首次访问出现 500 错误且控制台无日志 → 很可能是缓存目录权限问题，运行 php bin/console cache:clear（开发环境可加 --env=dev）
- 紫色调试栏不出现 → 检查 .env 文件中是否为 APP_ENV=dev 和 APP_DEBUG=1，两者缺一不可
- 首页能打开，但访问 /home 路由报错 → 说明控制器未生成或路由未注册，确认是否执行了 php bin/console make:controller HomeController，且方法返回了 render()
不复杂但容易忽略
