Symfony数据库连接核心是将合法、完整、可连通的DATABASE_URL写入.env文件，doctrine.yaml仅启用组件和映射；需确保协议头、127.0.0.1地址、serverVersion、URL编码及charset参数正确，并通过doctrine:database:create验证权限与认证。
Symfony 安装后连接 MySQL，核心就一条：把合法、完整、可连通的数据库连接串写进 .env 文件的 DATABASE_URL 变量里。其他配置（比如 doctrine.yaml）只负责启用组件和定义映射规则，不参与实际建连。
正确配置 .env 中的 DATABASE_URL
这是最关键的一步，错一个字符都可能连不上。标准格式如下：
-
必须带协议头：以
mysql://开头，不能省略 -
用 127.0.0.1，别用 localhost：避免 MySQL 尝试走 Unix socket，引发
No such file or directory错误 -
显式声明 serverVersion：MySQL 8.0 写
?serverVersion=8.0，5.7 就写5.7；Doctrine 靠它生成兼容语法 -
密码含特殊字符要 URL 编码：比如
pass@word→pass%40word，my/pwd→my%2Fpwd -
推荐加上 charset：末尾追加
&charset=utf8mb4，确保 emoji 和四字节中文能存
示例（MySQL 8.0，本地开发）：
DATABASE_URL="mysql://root:my%40pass@127.0.0.1:3306/symfony?serverVersion=8.0&charset=utf8mb4"验证连接与创建数据库
配完不是马上就能用，得先确认 Doctrine 能真正连上并建库：
- 运行
php bin/console doctrine:database:create—— 成功说明用户有CREATE权限且网络/认证无问题 - 若报
Access denied，不是 URL 写错了，而是 MySQL 用户权限不足或认证插件不兼容（尤其 MySQL 8.0 默认禁用mysql_native_password） - 解决权限问题：登录 MySQL 执行
GRANT CREATE, SELECT, INSERT, UPDATE, DELETE ON symfony.* TO 'root'@'%'; - 解决认证问题：执行
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'my%40pass';
生成实体与建表（用迁移方式）
不要用过时的 doctrine:schema:update --force，它跳过历史、破坏一致性、生产禁用：
- 先生成实体类：
php bin/console make:entity User，按提示输入字段（如name字符串、age整数） - 再生成迁移文件：
php bin/console make:migration，它会自动对比实体与当前库结构，生成 SQL - 最后执行迁移：
php bin/console doctrine:migrations:migrate，安全建表或改结构
迁移文件会记录在 migrations/ 目录下，便于团队协同和回滚。
测试环境数据库隔离配置
测试不能共用开发库，否则数据污染、无法重置：
- 在项目根目录新建
.env.test，内容如：
DATABASE_URL="sqlite:///%kernel.project_dir%/var/test.db"
或 MySQL 方式：
DATABASE_URL="mysql://test_user:test_pass@127.0.0.1:3306/test_symfony?serverVersion=8.0" - 运行测试时确保
APP_ENV=test生效（PHPUnit 默认加载.env.test） - 测试启动前可用
php bin/console doctrine:database:create --env=test自动建测试库
