新建 symfony 项目绑定 mysql 数据库需三步：一是在 .env 中正确配置 database_url，含 url 编码、显式 serverversion 和 charset；二是运行 doctrine:database:create 验证连接并解决权限或认证问题；三是用 make:entity、make:migration 和 doctrine:migrations:migrate 安全建表。
新建 Symfony 项目后绑定 MySQL 数据库，关键不是改配置文件的“数量”，而是确保 Doctrine 能从 .env 正确读取连接参数并完成建连验证。整个流程分三步：写对连接串、确认权限与认证、生成结构。
第一步：在 .env 中写准 DATABASE_URL
打开项目根目录下的 .env 文件，找到或新增这一行：
DATABASE_URL="mysql://root:my%40pass@127.0.0.1:3306/symfony?serverVersion=8.0&charset=utf8mb4"
- 协议头必须是
mysql://，不能省略 - 用
127.0.0.1替代localhost，避免 Unix socket 错误（报错 No such file or directory） - 密码含
@、/、:等字符时，必须 URL 编码（如pass@word→pass%40word） -
serverVersion必须显式指定（MySQL 8.0 写8.0，5.7 写5.7），否则 DQL 或迁移可能语法不兼容 - 推荐加上
&charset=utf8mb4，支持 emoji 和四字节中文
第二步：验证连接并创建数据库
运行命令检查 Doctrine 是否能真正连上：
php bin/console doctrine:database:create --if-not-exists
- 成功说明网络通、用户有
CREATE权限、认证方式兼容 - 若报
Access denied，不是 URL 写错了，而是 MySQL 用户权限不足：登录 MySQL 执行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';
第三步：生成实体并执行迁移建表
不要用已废弃的 doctrine:schema:update --force，改用迁移机制：
- 生成实体类：
php bin/console make:entity User（按提示输入字段，如name字符串、email唯一等） - 生成迁移文件：
php bin/console make:migration（Doctrine 自动对比实体与当前库结构） - 执行迁移：
php bin/console doctrine:migrations:migrate（安全建表，记录可追溯、可回滚）
