Symfony中多库配置需在doctrine.yaml中显式声明connections和entity_managers，否则getManager('secondary')返回null；.env中DATABASE_URL必须URL编码且用127.0.0.1；DBAL连接通过getConnection('name')获取，ORM管理器通过getManager('name')获取。
在 Symfony 项目中创建数据库连接，核心是让 Doctrine 能从 .env 读取连接串并正确加载到 DBAL 层；多库配置不是简单复制 DATABASE_URL，必须在 doctrine.yaml 中显式声明多个 connection 并为每个绑定独立的 entity manager，否则调用时会静默 fallback 到 default 或返回 null。
基础单库连接：从 .env 写起
打开项目根目录下的 .env 文件，在末尾添加一行（替换为你的真实参数）：
DATABASE_URL="mysql://root:password@127.0.0.1:3306/myapp?serverVersion=8.0&charset=utf8mb4"
这一步必须用 127.0.0.1 而非 localhost，否则 MariaDB/MySQL 可能尝试走 Unix socket 导致报错 SQLSTATE[HY000] [2002] No such file or directory；密码含 @ / : 等字符时，必须 URL 编码，例如 pass@word → pass%40word。
确保 config/packages/doctrine.yaml 中 dbal.url 字段已删除或注释掉，只保留 %env(resolve:DATABASE_URL)% 引用方式。
多数据库连接：定义 connection + 绑定 entity manager
第一步：在 .env 中新增第二个环境变量，名称需全大写、下划线分隔：
DATABASE_URL_SECONDARY="mysql://user:pass%2F123@192.168.0.2:3306/legacy?serverVersion=5.7"
第二步：修改 config/packages/doctrine.yaml，在 dbal.connections 下增加命名连接：
connections:
default:
url: '%env(resolve:DATABASE_URL)%'
server_version: '8.0'
driver: 'pdo_mysql'
secondary:
url: '%env(resolve:DATABASE_URL_SECONDARY)%'
server_version: '5.7'
driver: 'pdo_mysql'
第三步：在 orm.entity_managers 下为 secondary 连接显式声明一个 entity manager：
entity_managers:
default:
connection: default
secondary:
connection: secondary
mappings:
App\Entity\Legacy\:
is_bundle: false
dir: '%kernel.project_dir%/src/Entity/Legacy'
注意：connection: secondary 中的 secondary 必须和上面 connections 下的 key 完全一致，大小写敏感；如果只写了 connection 但没在 entity_managers 下声明 secondary manager，$registry->getManager('secondary') 将返回 null 而不报错，极易埋坑。
代码中获取指定数据库的 EntityManager
方法一：在控制器或服务中注入 ManagerRegistry 接口：
use Doctrine\Persistence\ManagerRegistry;
public function __construct(private ManagerRegistry $registry) {}
方法二：调用 getManager() 并传入 entity manager 名称（不是 connection 名）：
$emDefault = $this->registry->getManager('default');
$emSecondary = $this->registry->getManager('secondary');
这里的字符串必须和 doctrine.yaml 中 orm.entity_managers 的键名严格一致。别再用已废弃的 getEntityManager() —— Symfony 4+ 后该方法已被移除。
方法三：如只需执行原生 SQL 而不涉及 ORM 映射，可直接取 DBAL Connection：
$conn = $this->registry->getConnection('secondary');
它不依赖 entity_managers 配置，只要 connections 下存在 secondary 就能取到。
