User实体必须显式指定connection，如@ORM\Entity(connection="auth_db")；自定义UserProvider需注入对应EntityManager并手动查询多库；角色表须与User同库，否则需改用非JOIN方式加载。
Doctrine 多连接下 User 实体必须绑定明确的 connection
默认情况下，User 实体会走 default 连接；如果你的用户数据分散在多个数据库（比如 auth_db 和 legacy_users），不显式指定连接会导致 Doctrine 报错或查到空数据。
解决方法是在实体类的 @ORM\Entity 注解中加 connection 属性：
/**
* @ORM\Entity(connection="auth_db")
*/
class User
{
// ...
}- 该配置只对当前实体生效，不影响其他实体
- 若使用
make:entity生成，需手动补上，脚手架不会自动识别多库场景 - 连接名（如
auth_db）必须与doctrine.dbal.connections中定义的一致
自定义 UserProvider 必须传入对应 EntityManager
当用户数据不在默认库时，不能直接用 EntityUserProvider，否则它会尝试从 default 连接加载 —— 即使实体标注了 connection="auth_db"，EntityUserProvider 仍可能忽略它。
你需要写一个轻量级的自定义 Provider：
class MultiSourceUserProvider implements UserProviderInterface
{
private EntityManagerInterface $authEm;
private EntityManagerInterface $legacyEm;
<pre class="brush:php;toolbar:false;">public function __construct(EntityManagerInterface $authEm, EntityManagerInterface $legacyEm)
{
$this->authEm = $authEm; // 来自 auth_db 连接
$this->legacyEm = $legacyEm; // 来自 legacy_users 连接
}
public function loadUserByIdentifier(string $identifier): UserInterface
{
// 先查 auth_db
$user = $this->authEm->getRepository(User::class)->findOneBy(['email' => $identifier]);
if ($user) {
return $user;
}
// 再查 legacy_users（注意：实体类需对应不同 connection）
return $this->legacyEm->getRepository(LegacyUser::class)->findOneBy(['email' => $identifier]);
}}
- 两个
EntityManagerInterface必须通过服务配置显式注入，不能靠 autowire 模糊匹配 - 确保
LegacyUser实体也标注了@ORM\Entity(connection="legacy_users") - 不要在
loadUserByIdentifier()里抛异常，返回null交给 Symfony 继续流程更安全
登录凭证校验时，getCredentials() 返回的字段要和 getUser() 匹配
如果你需要按「邮箱 + 公司」双条件登录（即同一邮箱在不同公司下是不同用户），getCredentials() 返回的数组必须包含这两个键，且 getUser() 中要用它们构造查询条件。
例如：
public function getCredentials(Request $request): array
{
return [
'email' => $request->request->get('_username'),
'company_code' => $request->request->get('company_code'), // 非标准字段，需前端传
];
}
<p>public function getUser(array $credentials, UserProviderInterface $userProvider): ?UserInterface
{
// 注意：这里不能直接 new User()，必须调用 $userProvider->loadUserByIdentifier()
// 正确做法是把 credentials 透传进自定义 Provider 的方法里
return $userProvider->loadUserByCredentials($credentials);
}-
loadUserByCredentials()是你自定义 Provider 新增的方法，Symfony 原生不提供 - Doctrine 查询必须显式使用
andWhere()拼多个条件，别依赖findOneBy()的键值对自动映射（它只支持单表单字段） - 如果 company_code 存在大小写或前导空格，务必在查询前 trim / strtolower，否则缓存或索引可能失效
角色（Role）从数据库加载时，关联表必须与 User 实体共用同一 connection
常见错误：User 在 auth_db，Role 在 system_db，但 @ORM\JoinTable 没指定 schema 或跨库不被支持 —— MySQL 不允许跨库 JOIN（除非用 FEDERATED 引擎，但 Doctrine 不兼容）。
正确做法只有两个：
- 把
roles表和user_roles关联表一起放在auth_db中（推荐） - 改用非 JOIN 方式加载角色：在
User实体里去掉@ORM\ManyToMany，改由自定义 Provider 在refreshUser()中手动查system_db并 setRoles()
后者意味着你得自己处理角色缓存、序列化、权限更新延迟等问题 —— 多数项目扛不住这种复杂度。
