database_url必须写为postgresql://user:password@127.0.0.1:5432/dbname?serverversion=13，协议头只能是postgresql://，host禁用localhost须用127.0.0.1，serverversion必须显式指定且密码特殊字符需url编码。
DATABASE_URL 必须写对，否则连不上 PostgreSQL —— Symfony 5.3 不再从 doctrine.yaml 读连接参数，所有数据库配置都集中到 .env。
怎么配 DATABASE_URL 才能连上 PostgreSQL
格式必须是：postgresql://user:password@127.0.0.1:5432/dbname?serverVersion=13（版本号按你实际 PostgreSQL 版本填）
-
postgresql://协议头不能写成pgsql://或postgres://，Doctrine 5.3 只认postgresql:// - 本地开发别用
localhost，改用127.0.0.1——PostgreSQL 默认禁用localhost的 TCP 连接，会 fallback 到 Unix socket，而 Symfony 5.3 的 Doctrine 不自动处理 socket 路径 -
serverVersion参数必须显式指定，否则 Doctrine 无法生成兼容的 DDL；PostgreSQL 13 写13，15 就写15，不能省略 - 密码含
:、@、/等字符时，必须 URL 编码，例如pass@word:123→pass%40word%3A123
doctrine:schema:create 报 “Connection refused” 怎么查
这个命令失败，90% 是 DATABASE_URL 里的 host/port/user/password 没通，不是权限问题。
- 先手动试连：
psql -h 127.0.0.1 -p 5432 -U your_user -d dbname，如果这里就拒绝，说明 PostgreSQL 服务没起来，或pg_hba.conf没开对应 IP 的信任规则 - Symfony 5.3 默认不启用
pdo_pgsql扩展，检查php -m | grep pgsql是否输出pgsql和pdo_pgsql - 若用 Docker，确认容器已启动且端口映射正确：
docker ps看PORTS列是否有0.0.0.0:5432->5432/tcp
在 Docker Compose 里连不到 postgres 容器怎么办
本地运行 Symfony 命令（如 doctrine:schema:create）时，DATABASE_URL 的 host 不能填容器名（如 db），因为宿主机 DNS 解析不到。
- 开发时把
DATABASE_URL改成postgresql://user:pass@host.docker.internal:5432/dbname?serverVersion=13——host.docker.internal是 Docker Desktop 提供的宿主网络别名，Windows/macOS 都支持 - Linux 用户需在
docker-compose.yml的services.app.extra_hosts中手动加host.docker.internal:host-gateway - CI 环境（如 GitHub Actions）里没有
host.docker.internal，得用services.postgres.ports映射的真实端口 +127.0.0.1
怎么拿到当前连接的 PostgreSQL 参数数组
别去解析 .env 或 doctrine.yaml，直接从 Doctrine 的 Connection 实例取。
- 在控制器或服务里注入
Doctrine\DBAL\Connection，调用$connection->getParams() - 返回数组包含
host、port、user、password、dbname、serverVersion等键，全部已解码、已默认补全 - 注意：该方法只在连接已初始化后可用；若在
Kernel::boot()前调用，会触发连接尝试，可能因配置错误提前崩掉
serverVersion —— 它不光影响建表语句，还决定 Doctrine 是否启用 JSONB 类型支持、是否允许 ON CONFLICT 语法。少写或写错，后续执行 make:migration 可能生成非法 SQL。
