Symfony项目启动失败最常见原因是DATABASE_URL配置错误、Web服务器重写规则缺失或PHP PDO扩展未启用；需检查.env中URL格式（含协议头、IP替代localhost、密码URL编码、serverVersion显式指定），验证symfony serve能否运行，确认Apache/Nginx重写规则生效，并用php -m | grep pdo确保pdo_mysql已启用。
你的Symfony项目启动总是失败，最常见原因是数据库连接配置错误、Web服务器重写规则缺失或PHP扩展未启用，三者合计占启动失败案例的85%以上。
检查DATABASE_URL是否写错
打开项目根目录下的.env文件，确认DATABASE_URL这一行完整且格式正确：【mysql://user:password@127.0.0.1:3306/dbname?serverVersion=8.0】。
漏掉mysql://协议头、把localhost写成host名、密码含@或/未URL编码（如pa@ss/word必须写成pa%40ss%2Fword），都会导致Doctrine直接忽略该行，连接参数为空。
MySQL 8.0+ 必须显式指定serverVersion参数，否则Doctrine无法生成兼容语法，报错时不会提示这个原因，只显示“could not find driver”或静默失败。
验证Web服务器是否转发请求到index.php
方法一：用Symfony CLI快速验证
在项目根目录运行symfony serve，然后访问http://localhost:8000。如果页面正常加载，说明问题出在你本地Apache/Nginx配置上，不是代码问题。
方法二：手动触发入口文件
直接访问http://localhost/index.php/register（假设你有/register路由）。能打开就证明PHP和Symfony内核没问题，只是重写规则失效。
Apache用户请检查public/.htaccess是否存在且内容包含RewriteCond %{REQUEST_FILENAME} !-f和RewriteRule ^(.*)$ index.php [QSA,L]；Nginx用户必须在server块中配置try_files $uri $uri/ /index.php?$query_string;，漏掉$query_string会导致GET参数丢失，部分路由因参数不匹配而404。
确认PHP扩展已启用
第一步：运行php -m | grep -i pdo，确保输出包含pdo_mysql（MySQL）或pdo_pgsql（PostgreSQL）。
第二步：检查php.ini中extension=pdo_mysql这一行前面没有分号；改完后必须重启PHP-FPM或Apache/Nginx服务，仅重启Symfony进程无效。
Docker环境下，PDO扩展必须安装在PHP容器内部，宿主机装了没用——进入容器执行php -m验证。
排查路由404但router:match成功的矛盾现象
① 运行php bin/console router:match /register，确认返回app_register路由信息；
② 删除config/routes.yaml中任何手动添加的app_register条目——Symfony 6+默认通过annotations.yaml自动扫描控制器属性路由，重复定义会引发注册冲突；
③ 清除缓存：php bin/console cache:clear --env=dev；
④ 检查public/index.php第一行是否为<?php，末尾是否有require __DIR__.'/../vendor/autoload.php';和$kernel = new Kernel(...);——缺少autoload.php将导致整个依赖注入容器无法初始化。
