合法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，它跳过迁移历史、无法回滚、生产环境直接禁用。必须走迁移流程。

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

• 先生成实体：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

多数人卡在第一步：连都连不上，就去调池子参数，反而掩盖了真实问题。