Symfony 8.1.9 连接 MySQL 的关键是正确配置 .env 中的 DATABASE_URL：协议为 mysql://，地址用 127.0.0.1，密码 URL 编码，显式指定 ?serverVersion=8.1.9&charset=utf8mb4。
Symfony 8.1.9 连接 MySQL，核心就是把一条合法、完整、可连通的 DATABASE_URL 写进 .env 文件，其他配置只是配合启用功能，不参与实际建连。只要 URL 写对了，后续流程基本不会卡在连接环节。
正确填写 .env 中的 DATABASE_URL
这是最关键的一步，错一个字符（比如漏斜杠、错端口、未编码特殊符号）都会导致 Connection refused 或 Authentication failed。
- 协议头必须是 mysql://，不能省略或写成 mysql:、pdo:mysql 等
- 地址用 127.0.0.1，别用 localhost —— 否则 MySQL 可能尝试 Unix socket，报 No such file or directory
- 显式声明 serverVersion：MySQL 8.1.9 就写
?serverVersion=8.1.9，Doctrine 靠它生成兼容 SQL - 密码含
@、/、:、%等需 URL 编码：如pass@word→pass%40word，my/pwd→my%2Fpwd - 推荐加上 &charset=utf8mb4：确保 emoji、生僻中文等四字节字符能正常存取
示例（假设 MySQL 8.1.9 运行在本地 3306，数据库名 symfony_app，root 密码为 P@ss/8.1）：
DATABASE_URL="mysql://root:P%40ss%2F8.1@127.0.0.1:3306/symfony_app?serverVersion=8.1.9&charset=utf8mb4"验证数据库权限与认证方式
配置完不是立刻就能用，得先让 Doctrine 真正连上并有建库权限：
- 运行
php bin/console doctrine:database:create - 成功 → 表示网络通、用户认证通过、且有 CREATE 权限
- 报 Access denied → 大概率是 MySQL 用户权限不足，或认证插件不兼容（MySQL 8.0+ 默认用 caching_sha2_password，而 Doctrine 默认只支持 mysql_native_password）
解决方法（登录 MySQL 执行）：
GRANT CREATE, SELECT, INSERT, UPDATE, DELETE ON symfony_app.* TO 'root'@'%' IDENTIFIED BY 'P@ss/8.1';ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'P@ss/8.1';
FLUSH PRIVILEGES;
用迁移方式安全建表（不推荐 schema:update）
不要用 doctrine:schema:update --force，它跳过历史记录、无法回滚、生产环境禁用。
- 生成实体类：
php bin/console make:entity User，按提示添加字段（如 name:string, email:string, isActive:boolean） - 生成迁移文件：
php bin/console make:migration—— 它会自动对比实体定义和当前数据库结构，生成 SQL - 执行迁移：
php bin/console doctrine:migrations:migrate，表就建好了，迁移记录存在migrations/目录下，方便协作与回退
注意测试环境隔离
测试不能共用开发数据库，否则测试数据污染开发状态，也无法干净重置：
- 在
.env.test中单独配置 DATABASE_URL，例如指向symfony_app_test库 - 运行测试前先创建测试库：
APP_ENV=test php bin/console doctrine:database:create - 再执行迁移：
APP_ENV=test php bin/console doctrine:migrations:migrate
