symfony 5.4 连接数据库核心是正确配置 .env 中的 database_url，需确保协议头（如 mysql://）、ip 地址（用 127.0.0.1 非 localhost）、serverversion、url 编码特殊字符及 charset=utf8mb4 参数齐全合法，再通过 doctrine:database:create 验证连通性与权限。
Symfony 5.4 连接数据库，核心就是配好 .env 文件里的 DATABASE_URL，Doctrine 其他配置只是启用组件和定义映射规则，不参与实际建连。
正确填写 .env 中的 DATABASE_URL
这一步出错，后面全白搭。必须确保格式合法、参数完整、地址可通：
- 协议头不能少：以
mysql://开头（PostgreSQL 用pgsql://，SQLite 用sqlite://） - 地址写
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 靠它生成兼容 SQL - 密码含特殊字符要 URL 编码：比如
pass@word→pass%40word，my/pwd→my%2Fpwd - 推荐加上
&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—— 成功说明连接串有效、用户有建库权限 - 如果报错，优先检查
.env里有没有拼错、端口是否被占、MySQL 是否在运行 - 首次建库后，再执行
php bin/console make:entity创建实体，然后php bin/console make:migration+php bin/console doctrine:migrations:migrate同步表结构
确认 DoctrineBundle 已启用
Symfony 5.4 默认已启用 DoctrineBundle，但如果你是从旧项目升级或手动删过配置，需检查 config/bundles.php 是否包含：
没有这行，doctrine: 开头的命令（如 doctrine:database:create）会提示“command not found”。
实体与数据库表的对应关系
Doctrine 通过 PHP 类（Entity）映射数据库表，关键点有：
- 实体类放在
src/Entity/目录下，用@ORM\Entity和@ORM\Table注解声明 - 主键字段加
@ORM\Id和@ORM\GeneratedValue；普通字段用@ORM\Column - 字段类型尽量匹配数据库实际类型（如
string对应VARCHAR，integer对应INT），避免迁移时类型推断偏差
