symfony 6.4 数据库连接配置必须写在.env文件的database_url中，常见错误包括缺失mysql://协议头、误用localhost导致unix socket路径错误、特殊字符未url编码、pdo扩展未启用或docker网络隔离导致主机名解析失败。
检查 DATABASE_URL 是否拼错或协议头缺失
Symfony 6.4 默认从 .env 文件读取数据库连接，不是 doctrine.yaml。最常见错误是 DATABASE_URL 缺少协议头或写成 localhost 导致走 Unix socket：
-
mysql://user:pass@127.0.0.1:3306/dbname?serverVersion=8.0✅ 正确（显式 IP + 端口） -
mysql://user:pass@localhost:3306/dbname❌ 可能报No such file or directory（MySQL 会尝试本地 socket） -
user:pass@127.0.0.1:3306/dbname❌ 缺少mysql://协议头，Doctrine 直接忽略整行 - 密码含
@、/、:必须 URL 编码，比如pa@ss/word→pa%40ss%2Fword
确认 PHP 的 PDO 驱动已启用且匹配协议
即使 DATABASE_URL 写对了，PHP 没装对应驱动也会报 could not find driver：
- 运行
php -m | grep -i pdo，确保输出包含pdo_mysql（MySQL）或pdo_pgsql（PostgreSQL） - 检查
php.ini中是否启用了扩展：搜索extension=pdo_mysql，确认前面没被分号;注释掉 - 改完
php.ini后必须重启 PHP-FPM 或 Apache/Nginx，仅重启 Symfony 服务无效 - Docker 环境下，驱动需在 PHP 容器内安装，不是宿主机上装了就行
验证数据库服务是否可从 Symfony 进程所在环境访问
“找不到数据库”不等于数据库没开，而是 Symfony 进程根本连不到它——尤其在 Docker 场景下：
- 如果数据库跑在 Docker 容器里，而 Symfony 在宿主机运行：
host不能填database或my_db（这是 Docker 内部服务名），得填容器实际 IP 或映射到宿主机的端口（如127.0.0.1:5433） - 用
telnet 127.0.0.1 5432或nc -zv 127.0.0.1 3306测试端口通不通；不通就查数据库容器是否启动、ports:是否暴露、防火墙是否拦截 - PostgreSQL 报
could not translate host name "xxx" to address，说明 DNS 解析失败，宿主机 hosts 文件没加映射，或没把 Symfony 也放进同一 Docker 网络
排查用户权限与认证方式兼容性
连接字符串和驱动都对，但报 Access denied 或静默失败，大概率是权限或认证插件问题：
-
doctrine:database:create是用DATABASE_URL里的用户执行建库，不是 root —— 确保该用户有CREATE权限：GRANT CREATE ON *.* TO 'user'@'%'; - MySQL 8.0+ 默认禁用
mysql_native_password插件，老项目用户可能仍用旧方式认证，需手动切换：ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pass'; - PostgreSQL 要确认
pg_hba.conf允许对应 IP 和认证方式（md5或trust），别只改postgresql.conf
真正卡住的地方往往不是配置写在哪，而是“Symfony 进程看到的世界”和“你认为它该看到的世界”不一致——比如宿主机以为数据库叫 localhost，其实它在 Docker 里叫 db 且只对容器网络可见；又比如你改了 php.ini，却忘了重启 PHP 进程。这些环境错位比语法错误更难一眼发现。
