Symfony 的数据库连接配置统一写在 .env 文件的 DATABASE_URL 中，而非 doctrine.yaml；需确保协议头、IP 地址、serverVersion、URL 编码等正确，并检查 MySQL 用户权限与认证方式。
Doctrine MySQL 连接配置写在哪
Symfony 的数据库连接信息统一放在 .env 文件里，不是 config/packages/doctrine.yaml —— 后者只负责启用组件和定义映射规则，真连不上 MySQL 是因为 .env 里的 DATABASE_URL 没配对。
常见错误现象：Connection refused、Access denied for user、甚至 SQLSTATE[HY000] [2002] No such file or directory（本地用 socket 连但路径不对）。
-
DATABASE_URL格式必须是mysql://user:password@127.0.0.1:3306/dbname?serverVersion=8.0，不能漏掉mysql://协议头 - 本地开发用
127.0.0.1，别写localhost—— MySQL 会尝试走 Unix socket，容易报No such file or directory -
serverVersion参数必须显式指定，否则 Doctrine 无法判断语法兼容性；MySQL 8.0 写8.0，5.7 就写5.7 - 密码含特殊字符（如
@、/）必须 URL 编码，例如pass@word→pass%40word
doctrine:database:create 报错说 “Access denied”
这个命令本质是用 DATABASE_URL 中的用户去连 MySQL 并执行 CREATE DATABASE，不是用 root。所以失败大概率是权限问题，不是配置写错了。
使用场景：CI 环境初始化库、新同事拉代码后一键建库。
- 确认
DATABASE_URL里的用户有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 镜像）默认禁用
old_passwords，老 Symfony 项目用的旧 auth plugin 可能连不上 —— 改用户认证方式：ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pass';
doctrine:schema:update --force 不生效或报错
这个命令在生产环境禁止使用，但在本地调试时经常被误用：它只对比当前实体（Entity/）和已存在的表结构，不读 migrations 历史，容易跳过中间变更、破坏数据一致性。
性能影响：全量扫描所有实体 + 所有表，大项目耗时明显；兼容性上，MySQL 8.0.23+ 对 ALTER TABLE ... ALGORITHM=INPLACE 更严格，有些字段修改会被拒绝。
- 优先用
php bin/console make:migration生成迁移文件，再php bin/console doctrine:migrations:migrate - 如果只是加个字段且确定无风险，可用
php bin/console doctrine:schema:update --dump-sql先看 SQL，确认无误再加--force - 注意：该命令不会删除字段或表（除非加
--complete），但--complete会清空未映射的表 —— 别在共享库上跑
MySQL 连接池与长连接超时
Symfony 默认每次请求都新建 PDO 连接，MySQL 默认 wait_timeout=28800（8 小时），但实际更早断连往往是因为网络中间件（如云服务商 LB、Docker bridge）主动 kill 空闲连接。
现象：偶发 MySQL server has gone away，尤其在低频访问的后台服务中。
- PHP 层可加
options: { !php/const PDO::ATTR_PERSISTENT: true }开启持久连接（仅限 CLI 或 php-fpm static 模式，CGI 下无效） - 更稳妥的是在
DATABASE_URL加参数：?connect_timeout=10&read_timeout=30&timeout=30，让 PDO 主动探测失效连接 - Doctrine 自带连接健康检查，但默认关闭；可在
doctrine.yaml加：options: { !php/const PDO::ATTR_ERRMODE: 2 }让异常抛出，配合重试逻辑
真正麻烦的不是配通，而是线上环境里 serverVersion 写错、密码没编码、或者用了 localhost 导致本地能跑线上连不上 —— 这些点没法靠 debug bar 看出来，得直奔 .env 和 MySQL 用户权限查。
