数据库连接配置必须写在.env文件的database_url中，doctrine.yaml仅启用组件和定义映射；需确保协议头、serverversion、url编码正确，并检查mysql用户权限与认证方式。
数据库连接配置写在哪？不是 doctrine.yaml
所有连接参数必须写在 .env 文件的 DATABASE_URL 里，config/packages/doctrine.yaml 只负责启用组件、定义映射和 ORM 行为——它不存用户名密码，也不解析连接串。连不上 MySQL，90% 是因为 .env 里的 DATABASE_URL 格式不对或权限没开。
-
DATABASE_URL必须带协议头：mysql://user:pass@127.0.0.1:3306/dbname?serverVersion=8.0 - 本地开发别用
localhost，改用127.0.0.1，否则 MySQL 会尝试走 Unix socket，报No such file or directory - 密码含
@、/、:等字符，必须 URL 编码，比如pa@ss/word→pa%40ss%2Fword -
serverVersion参数不可省略，MySQL 8.0 写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 环境连不上？检查这三处
内网域名、防火墙、PHP 扩展缺一不可。常见错误不是 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等键 - 注意：这个方法返回的是 Doctrine 解析后的最终值，已自动处理 URL 编码、默认端口（3306）、
serverVersion等，比读.env更可靠
真正容易被忽略的，是 serverVersion 和密码 URL 编码这两项——它们不出错时不显眼，一出错就是 SQLSTATE[HY000] 或语法不兼容，查日志也看不出根源。每次换 MySQL 版本或改密码，都得重新核对这两处。
