Symfony 7 安装失败90%是环境问题：PHP版本必须≥8.2，需验证php -v、五个扩展（intl/mbstring/xml/curl/fileinfo）、DATABASE_URL权限及Web服务器路由转发是否正确。
Symfony 7 安装失败，90% 是环境没调通，不是代码或配置写错了。 直接看报错类型，对应查 PHP 版本、扩展、网络、权限这四块，别先翻文档改 YAML。
PHP 版本低于 8.2 导致 composer require 失败
Symfony 7.4 要求 PHP ≥ 8.2，composer create-project symfony/skeleton 或 composer require symfony/symfony:^7.4 报 Your requirements could not be resolved，基本就是这个原因。
- 运行
php -v确认输出是PHP 8.2.x或8.3.x（8.3 兼容）；Windows 用户注意 CLI 和 Web 用的可能是不同 php.ini，必须查命令行输出 - Docker 用户别用
php:8.1-apache镜像，换成php:8.2-apache或更高 - 别加
--ignore-platform-req=php强行安装——cache:warmup 或首次请求时大概率崩溃
doctrine:database:create 报 Access denied
这不是 .env 里密码写错了，而是 DATABASE_URL 指定的用户（比如 app_user）根本没被授予建库权限。
- 先手动连：运行
mysql -u app_user -p -h 127.0.0.1 -P 3306，看是否同样报Access denied - 若连不上，登录 MySQL root 执行：
GRANT CREATE ON *.* TO 'app_user'@'%' IDENTIFIED BY 'your_pass'; FLUSH PRIVILEGES; - Docker + MySQL 8.0 时，可能因认证插件不兼容，补一句：
ALTER USER 'app_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass'; - 云数据库（如阿里云 RDS）要检查白名单是否包含应用服务器的 IP
本地部署后路由全 404
404 不是路由没定义，是请求压根没进 Symfony 内核。先确认 Web 服务器是否把请求正确转发到 public/index.php。
- 直接访问
https://yoursite.com/public/index.php，能加载欢迎页说明 PHP 和框架没问题；404 或空白就查文件权限、autoload.php路径、或index.php是否被意外修改 - Apache 用户：确认启用了
mod_rewrite，且虚拟主机中设置了AllowOverride All，public/.htaccess文件存在且内容含标准重写规则 - Nginx 用户：必须显式配
try_files $uri $uri/ /index.php?$query_string;，漏掉$query_string会导致 GET 参数丢失，部分路由匹配失败 - 临时在
public/index.php第一行加<?php die('reached');，刷新首页——看到文字说明重写生效；仍 404 就是 Web 服务器配置问题
DATABASE_URL 密码含 @ / : 导致连接凭据解析错误
URL 中特殊字符未编码，parse_url() 会提前截断，比如 mysql://user:pa@ss/word@127.0.0.1:3306/db 实际被拆成 user=user、pass=pa、host=ss，完全错乱。
- 必须对密码做 URL 编码：用 PHP 函数
rawurlencode('pa@ss/word')得到pa%40ss%2Fword -
DATABASE_URL应写成：mysql://user:pa%40ss%2Fword@127.0.0.1:3306/db?serverVersion=8.0 - 别依赖 IDE 自动编码——有些编辑器会双编码；手动用在线工具或
php -r "echo rawurlencode('...');"校验一次 - localhost 必须换 127.0.0.1，否则 PHP 尝试走 Unix socket，Docker 或某些 MySQL 配置下路径不一致，报
No such file or directory
真正卡住人的，往往不是 Doctrine 配置或路由写法，而是 php -v 没看清是 CLI 还是 Web 模式、mysql -u 手动连不通却去改 messenger.yaml、或者把 localhost 当万能主机名硬塞进 DATABASE_URL —— 这些点不先钉死，后面所有调试都是在绕圈。
