连不上数据库90%是DATABASE_URL格式错误而非Doctrine配置问题；必须写在.env中，含mysql://协议、127.0.0.1（非localhost）、URL编码密码、显式serverVersion，且需确保MySQL用户权限、网络连通性及pdo_mysql扩展启用。
连不上数据库？90% 是 DATABASE_URL 格式不对，不是 Doctrine 配错了。
DATABASE_URL 必须写在 .env 里，不是 doctrine.yaml
所有连接参数（用户名、密码、host、port、dbname、serverVersion）只能放在 .env 文件的 DATABASE_URL 变量中。config/packages/doctrine.yaml 只负责启用组件、定义映射路径和 ORM 行为，它不解析连接串，也不存敏感信息。
-
doctrine.yaml里只该有url: '%env(DATABASE_URL)%'这一行指向环境变量 - 本地开发用
127.0.0.1，别写localhost—— 否则 MySQL 会尝试走 Unix socket，报错No such file or directory - 密码含
@、/、:等字符，必须 URL 编码：比如pa@ss/word→pa%40ss%2Fword -
serverVersion参数不可省：MySQL 8.0 写?serverVersion=8.0，5.7 就写5.7；缺了它，Doctrine 无法适配 JSON 函数、窗口函数等语法
doctrine:database:create 报 “Access denied” 怎么办
这个命令不是用 root 连，而是直接拿 DATABASE_URL 里的用户去执行 CREATE DATABASE。失败不是配置写错了，是权限不够。
- 确认该用户有
CREATE权限：GRANT CREATE ON *.* TO 'your_user'@'%'; - 如果只想建指定库，可手动建：
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS dbname;"，再跑php bin/console doctrine:schema:create - Docker 环境（如
mysql:8.0）默认禁用旧认证插件，老用户连不上：执行ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pass';
云服务器或 Docker 连不上？先查这三处
常见错误根本不是 Doctrine 配错，而是底层网络或运行时环境没准备好。
- 主机名填内网 IP 或 DNS（如
db.internal），不能写localhost或127.0.0.1（容器间通信走宿主机网络） - 云服务商安全组 / Docker network / iptables 必须放行目标端口（MySQL 默认
3306） - 确认 PHP 已启用
pdo_mysql：运行php -m | grep pdo_mysql，没输出就装：sudo apt install php-mysql，然后重启 PHP-FPM 或 Apache
想把当前连接参数转成数组？别手动 parse
不要自己写逻辑从 DATABASE_URL 字符串里提取 host/user/port——Doctrine 的 Connection 实例已经帮你解析好了，直接用就行。
- 在服务或控制器中注入
Doctrine\DBAL\Connection - 调用
$connection->getParams()，返回数组包含host、port、user、password、dbname等键 - 注意：
getParams()返回的是 Symfony 解析后的最终值，不代表 MySQL 实际可连通状态——它不验证网络、权限或认证方式
最易被忽略的点：serverVersion 不匹配导致 SQL 执行失败，但错误提示往往不明确；还有就是 Docker 容器间用 localhost 死连不上，这种问题查日志永远找不到根因。
