Symfony数据库连接核心是将合法、完整、可连通的DATABASE_URL写入.env文件，doctrine.yaml仅启用组件和映射，不参与实际连接；需注意协议头、127.0.0.1代替localhost、显式serverVersion、密码URL编码、charset=utf8mb4等要点。
Symfony 连接数据库不靠写一堆配置，核心就一条：把合法、完整、可连通的 DATABASE_URL 写进 .env 文件。其他文件（比如 doctrine.yaml）只管启用组件、定义映射或声明多连接，不参与实际建连。
MySQL 连接要点
本地开发别用 localhost，改用 127.0.0.1，避免触发 Unix socket 导致 No such file or directory 错误；serverVersion 必须显式声明（如 ?serverVersion=8.0），否则 Doctrine 可能降级语法，JSON 字段或窗口函数会失效；密码含 @、/、: 等要 URL 编码（pass@word → pass%40word）；强烈推荐加上 &charset=utf8mb4，防止 emoji 或四字节中文存不进库。
DATABASE_URL="mysql://app:my%40pass@127.0.0.1:3306/myapp?serverVersion=8.0&charset=utf8mb4"- MySQL 8.0 默认禁用
mysql_native_password插件，连不上时执行：ALTER USER 'app'@'%' IDENTIFIED WITH mysql_native_password BY 'my%40pass'; - 用户至少要有
CREATE, SELECT, INSERT, UPDATE, DELETE权限：GRANT CREATE, SELECT, INSERT, UPDATE, DELETE ON myapp.* TO 'app'@'%';
PostgreSQL 连接要点
协议头换为 pgsql://，端口默认是 5432；serverVersion 同样不可省（如 ?serverVersion=14）；PostgreSQL 用户名和数据库名区分大小写，URL 中需保持一致；若使用 postgres 系统用户，注意它默认无密码且可能被 pg_hba.conf 限制连接方式（如仅 peer 认证）。
DATABASE_URL="pgsql://app:my%40pass@127.0.0.1:5432/myapp?serverVersion=14&charset=utf8"- 确认
pg_hba.conf允许md5或scram-sha-256认证方式，例如：host all all 127.0.0.1/32 md5 - 首次连接前，确保目标数据库已存在（PostgreSQL 不支持自动创建库），可用
createdb -U app myapp
SQLite 连接要点
最轻量，无需服务进程，适合开发或小型应用；URL 中路径必须是绝对路径，推荐用 %kernel.project_dir% 占位符；不需要 serverVersion 或 charset 参数；文件目录需有写权限，否则建表失败报 unable to open database file。
DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db"- 确保
var/目录存在且 Web 服务器用户（如 www-data）有读写权限 - SQLite 不支持某些 ORM 功能（如数据库级唯一约束跨字段、外键级联动作需手动开启 PRAGMA）
验证与常用命令
连通性验证优先用控制台命令，比写代码更快定位问题：
-
php bin/console doctrine:database:create—— 创建库（MySQL/PostgreSQL）或初始化 SQLite 文件 -
php bin/console doctrine:database:drop --force—— 删除库（慎用） -
php bin/console doctrine:schema:validate—— 检查实体与数据库结构是否一致 -
php bin/console doctrine:query:sql "SELECT 1"—— 执行原生 SQL，快速确认连接可用
不复杂但容易忽略。
