Doctrine DBAL 配置应写在 config/packages/doctrine.yaml 的 doctrine.dbal 下，而非 doctrine.orm；必须二选一：用完整 DSN URL（如 mysql://u:p@db.internal:3306/d?charset=utf8mb4）或显式字段（driver、host、port 等），不可混用；charset 必须设为 utf8mb4，云环境禁用 localhost，特殊字符需 URL 编码。
Doctrine DBAL 配置在 Symfony 里怎么写
直接改 config/packages/doctrine.yaml，别碰 doctrine.orm 部分——那是 ORM 层的，DBAL 是底层连接层，配置项在 doctrine.dbal 下。你只需要数据库驱动、URL 或显式参数、字符集这三块就跑得起来。
常见错误是把 url 和 host/port 混着写，导致 Doctrine 用两个不同逻辑解析连接信息，最终连错库或报 Connection refused。正确做法是二选一：url 优先（推荐），或全用显式字段（driver, host, port, dbname 等）。
-
url必须是完整 DSN，例如mysql://user:pass@db.internal:3306/myapp?charset=utf8mb4；特殊字符如@或/要 URL 编码 - 若用显式字段，
driver值必须是pdo_mysql、pdo_pgsql等，不能写成mysql -
charset设为utf8mb4，否则 emoji 和部分生僻字存不进去 - 云环境务必用内网域名（如
db.internal），别写localhost或127.0.0.1——容器或远程 DB 会连自己
为什么 getParams() 返回的数组和配置对不上
因为 Doctrine\DBAL\Connection::getParams() 返回的是运行时已解析、归一化后的连接参数，不是原始 YAML。比如你配了 url: mysql://u:p@h:3306/d?charset=utf8mb4，getParams() 会拆成 ['driver' => 'pdo_mysql', 'host' => 'h', 'port' => 3306, 'dbname' => 'd', 'charset' => 'utf8mb4']，但不会保留原始 query string 结构。
所以别拿它反推配置是否写对——它只反映“当前连接实际用了什么”，不反映“你写了什么”。验证配置是否生效，应该用命令：php bin/console doctrine:database:create --if-not-exists 或直接 php bin/console debug:config doctrine 看输出里的 dbal 节点。
DBAL 查询超时和连接池怎么调
Symfony 默认没开连接池，DBAL 每次 getConnection() 都新建 PDO 实例。高并发下容易耗尽 MySQL 连接数。要控制，得在 doctrine.dbal 下加 options 和 driver_options：
-
options控制 DBAL 行为：设'PDO::ATTR_TIMEOUT' => 5防查询卡死 -
driver_options透传给 PDO 构造函数：加PDO::ATTR_PERSISTENT => true启持久连接（注意 MySQL 服务端也要允许） - 真正连接池得靠外部组件（如 PgBouncer / ProxySQL），DBAL 本身不提供池管理
- 云上部署记得调
wait_timeout（MySQL）和connect_timeout（PHP），避免连接被中间网络设备静默断开
DBAL 直接查 vs ORM 查询器，什么时候该用哪个
查结构简单、不涉及对象映射、或者要拼动态 SQL（比如按用户输入字段排序/筛选）时，用 DBAL 更轻量。ORM 的 QueryBuilder 是为实体设计的，一旦表结构没对应实体，或要跨库 JOIN，它反而绕路。
示例场景对比：
- 导出报表统计：用
$connection->executeQuery("SELECT COUNT(*) FROM orders WHERE status = ?", [$status])，快且可控 - 需要返回
User对象并自动处理关联：必须走 ORM 的getRepository(User::class) - 执行 DDL（如
CREATE TABLE）或存储过程：只能用 DBAL，ORM 不支持 - 事务里混合 DML + DDL：DBAL 支持
transactional()，但要注意某些 DDL 语句（如 MySQL 的ALTER TABLE）会隐式提交事务
最易忽略的一点：DBAL 查询结果默认是关联数组，不是对象；如果后续还要塞进 Serializer 或 API 响应，得自己处理键名大小写、空值转换等细节——ORM 自动做了这些。
