Symfony 不支持跨数据库 SQL 查询，仅支持应用层多库协同；需在 doctrine.yaml 中配置多个 connection 和 entity manager，显式指定 EM 操作对应库，跨库事务需最终一致，读取通过 PHP 合并结果。
Symfony 本身不原生支持“跨数据库查询”（比如一条 DQL 或 QueryBuilder 同时 JOIN MySQL 和 PostgreSQL 中的表），因为 Doctrine ORM 的设计原则是单连接、单数据库上下文。所谓“多库协同”，实际是指在同一个 Symfony 应用中安全、可控地操作多个独立数据库连接，并在业务逻辑层协调数据——不是 SQL 层面的跨库 JOIN，而是应用层的分库路由与聚合。
明确多数据库配置方式
Symfony + Doctrine 支持为不同实体或用途定义多个 Entity Manager（即多个数据库连接）。关键在 doctrine.yaml 中声明多个 connection 和对应的 entity manager：
- 每个
connection配置独立的 host、dbname、user 等参数 - 每个
entity_manager绑定一个 connection，并可指定其管理的实体命名空间（如App\Entity\User→ default EM；App\Entity\Report→ reporting EM） - 可通过
resolve_target_entities或自定义 Repository 显式指定使用哪个 EM
按需获取对应 EntityManager
不能混用 EntityManager 实例。查用户走 user EM，查日志走 log EM，必须显式选择：
- 在 Controller 或 Service 中，通过
$this->getDoctrine()->getManager('user')获取指定 EM - 更推荐依赖注入：在服务定义中注入
@doctrine.orm.user_entity_manager或@doctrine.orm.reporting_entity_manager - Repository 类需继承
ServiceEntityRepository并在构造中接收对应 EM，避免硬编码getManager()
实现跨库业务逻辑协同
典型场景：下单后，主库写订单（MySQL），同时向分析库写快照（PostgreSQL）。这不是一次查询，而是事务性写入编排：
立即学习“PHP免费学习笔记（深入）”；
- 用
TransactionManager分别开启两个连接的事务（注意：无法保证跨库强一致性，需接受最终一致） - 先写主库订单，获取 ID；再用该 ID 构造分析库所需数据，调用 reporting EM 写入
- 任一失败需人工补偿或引入消息队列解耦（如 Messenger + SQS/RabbitMQ）
- 读取类场景（如后台报表页展示用户数+活跃设备数）：分别查两个库，PHP 层合并数组，不拼 SQL
避免常见陷阱
多库不是“魔法开关”，配置错一步就查不到数据：
- 实体类必须标注
@ORM\Entity(repositoryClass="...")，且 Repository 构造函数中传入的是目标 EM，否则仍走默认库 - DQL 不支持跨库表名引用（如
SELECT u FROM user_db:User u是非法语法） - Schema 工具（
doctrine:schema:update）默认只作用于default连接，多库需加--em=xxx参数 - 缓存键需包含 EM 名称前缀，防止不同库的数据被错误复用
