mysql的database_url格式为mysql://username:password@127.0.0.1:3306/dbname?serverversion=8.0，必须含mysql://前缀、端口、serverversion参数并url编码特殊字符，禁用localhost改用127.0.0.1。
MySQL 的 DATABASE_URL 格式和常见写错点
直接写：mysql://username:password@127.0.0.1:3306/dbname?serverVersion=8.0。不加 mysql:// 前缀或漏掉端口，Symfony 启动时会报 Invalid URL 或 Driver not found。
关键细节：
-
username和password里如果含特殊字符（比如@、/、:），必须用urlencode()编码，否则解析失败；本地开发常用root密码为空，可写成mysql://root:@127.0.0.1:3306/dbname -
serverVersion参数不是可选的——Symfony 5.4+ 强制要求，否则 Doctrine 报Could not determine driver type；填错版本（比如把 MySQL 5.7 写成 8.0）会导致 DDL 语句生成错误 - 不要写
localhost，它在 Docker 或某些系统下会走 socket 而非 TCP，改用127.0.0.1更可靠
PostgreSQL 的 DATABASE_URL 必须带 options 参数
正确写法：postgresql://user:pass@127.0.0.1:5432/dbname?application_name=symfony&charset=utf8。缺 application_name 不报错，但查 pg_stat_activity 时看不到来源，排查连接泄漏困难。
容易踩的坑：
- PostgreSQL 驱动识别依赖
postgresql://协议头，写成pgsql://或postgres://都会失败（Doctrine 只认postgresql） - 密码含
%或+时，必须编码，例如原密码ab%cd+ef→ab%25cd%2Def - 若数据库启用了 SSL，需加
&sslmode=require，否则连接被拒绝且错误信息模糊（只报Connection refused）
Symfony 环境变量加载顺序导致的覆盖问题
DATABASE_URL 在 .env 里定义，但会被 .env.local 覆盖，而后者常被 git 忽略——这意味着你改了 .env 却没生效，实际连的是旧配置。
验证方式：
- 运行
php bin/console debug:container --env-vars | grep DATABASE_URL，看输出是否是你预期的值 - 执行
php bin/console doctrine:database:create --if-not-exists，失败时注意错误里显示的 host/port 是否匹配你写的 URL - 如果用 Docker Compose，确保容器内读取的是宿主机 IP（如
host.docker.internal），而不是localhost（它指向容器自身）
SQLite 的 DATABASE_URL 容易忽略路径权限
格式是：sqlite:///%kernel.project_dir%/var/data.db。注意：%kernel.project_dir% 是 Symfony 的参数占位符，只在 URL 解析时生效，不能写成绝对路径如 /app/var/data.db（容器里路径不同）。
典型故障：
- 目录
var/没有写权限，报Unable to create or open file；运行chmod -R 777 var/临时解决，但生产环境应设为www-data:www-data - URL 中的
sqlite://后必须跟/，少一个斜杠（如sqlite:/var/data.db）会被当成内存数据库，每次请求都新建空库 - 测试环境常用
sqlite:///:memory:，但它不支持外键约束，开启doctrine.dbal.urls里的enable_foreign_keys=true会静默失效
URL 解析发生在容器编译期，改完要清缓存；dev 环境下缓存可能不自动刷新，强制跑一次 php bin/console cache:clear 最稳妥。
