合法DATABASE_URL必须含mysql://协议、127.0.0.1地址、URL编码密码、显式serverVersion和charset，如DATABASE_URL="mysql://root:my%40pass@127.0.0.1:3306/symfony?serverVersion=8.0&charset=utf8mb4"。
DATABASE_URL 必须写对，否则连不上，不是配得“多”就有效
怎么写合法的 DATABASE_URL
Doctrine 只认 DATABASE_URL 环境变量，其他配置（比如 doctrine.yaml）不参与建连逻辑。错一个字符都可能报 No such file or directory 或 Access denied。
- 协议头必须是
mysql://，不能省略或写成mysql: - 地址用
127.0.0.1，别用localhost—— 否则 MySQL 会尝试 Unix socket，本地开发常见报错No such file or directory - 密码含
@、/、:等字符时，必须 URL 编码：比如pass@word→pass%40word，my/pwd→my%2Fpwd -
serverVersion必须显式指定：?serverVersion=8.0（MySQL 8.0）、?serverVersion=5.7（MySQL 5.7），否则 DQL 解析或迁移生成 SQL 可能语法不兼容 - 推荐加
&charset=utf8mb4，避免 emoji 和四字节中文存不进去
示例（MySQL 8.0，本地 root 用户）：
DATABASE_URL="mysql://root:my%40pass@127.0.0.1:3306/symfony?serverVersion=8.0&charset=utf8mb4"
为什么 doctrine:database:create 会失败
运行 php bin/console doctrine:database:create --if-not-exists 不是走个过场，它是唯一能验证连接真实性的命令。失败原因几乎都集中在权限或认证插件上，而不是 URL 写错了。
- 报
Access denied：大概率是 MySQL 用户没给CREATE权限，执行GRANT CREATE, SELECT, INSERT, UPDATE, DELETE ON symfony.* TO 'root'@'%'; - MySQL 8.0 官方 Docker 镜像默认禁用
mysql_native_password插件，需手动切回：ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'my%40pass'; - 如果用的是 MAMP/XAMPP，检查它是否绑定了
127.0.0.1:3306而非仅localhost，端口也可能不是 3306
实体和表怎么安全建出来
别碰 doctrine:schema:update --force，它跳过迁移历史、无法回滚、生产环境直接禁用。必须走迁移流程。
- 先生成实体：
php bin/console make:entity User，按提示输字段（如name:string、email:string unique） - 再生成迁移文件：
php bin/console make:migration，它自动对比当前实体与数据库结构差异 - 最后执行迁移：
php bin/console doctrine:migrations:migrate，SQL 才真正落地
迁移文件会存在 migrations/ 目录下，这是团队协作和上线回滚的依据，删了就丢历史。
serverVersion 和 pooling 是真生效还是白配
serverVersion 不只是“建议填写”，它是 Doctrine 生成 SQL 的语法锚点。没它，MySQL 8.0 的 JSON_CONTAINS 或 5.7 的 GROUP_CONCAT 可能被错译。
至于连接池（pooling: true）：
- 在 PHP-FPM 下基本无效 —— 进程隔离模型导致连接无法跨请求复用，
pooling配置会被静默忽略 - 只有 Swoole（需
coroutine => enabled）、RoadRunner 等常驻内存运行时才真正支持池化 - 即使启用，也必须满足三个硬条件：PHP ≥ 8.1、Doctrine Bundle ≥ 2.10、
DATABASE_URL中带serverVersion
多数人卡在第一步：连都连不上，就去调池子参数，反而掩盖了真实问题。
