doctrine一对一关系需明确外键在拥有方（如profile），user为反向方；双向映射需inversedby/mappedby配对；迁移验证确保user_id唯一外键；查询用leftjoin+addselect避免n+1。
Doctrine 一对一（OneToOne）关系在 Symfony 6.4 中主要用于拆分主表、隔离敏感字段或扩展实体能力，比如用户（User）与其个人资料（Profile）。它不是简单“加个属性”就行，关键在于外键位置、双向映射控制和查询时的加载策略。
实体定义：明确谁持有外键
一对一关系中，外键必须落在“拥有方”（owning side）上。通常把外键放在扩展性更强、非必需的那张表里——比如 profile 表包含 user_id 字段并设为主键或唯一外键，这样能确保一个用户最多只有一个档案。
- User 实体（被引用方 / inverse side）：不存外键，只声明反向关联
-
Profile 实体（拥有方 / owning side）：用
@ORM\JoinColumn明确外键字段，并指向User的主键
示例（src/Entity/Profile.php）：
use Doctrine\ORM\Mapping as ORM;
#[ORM\Entity]
class Profile
{
#[ORM\Id]
#[ORM\GeneratedValue]
#[ORM\Column(type: 'integer')]
private ?int $id = null;
#[ORM\OneToOne(inversedBy: 'profile', targetEntity: User::class)]
#[ORM\JoinColumn(name: 'user_id', referencedColumnName: 'id', unique: true)]
private ?User $user = null;
// getter/setter 省略
}
双向关联：让两边都能访问对方
仅单向关联会导致 $user->getProfile() 无法工作。要支持双向，需在 User 实体中补全 inversedBy 对应的属性，并设为 mappedBy：
private ?Profile $profile = null;
注意：cascade 和 orphanRemoval 不是必须，但常用于自动管理生命周期（如删用户时连带删档案）。
数据库迁移与验证
写完注解后，运行命令生成并执行迁移：
php bin/console doctrine:migrations:diffphp bin/console doctrine:migrations:migrate
检查生成的 SQL 是否创建了 profile.user_id 字段，并带 UNIQUE 约束和外键引用。也可用以下命令验证映射是否合法：
查询时避免 N+1：用 join 加载关联数据
默认情况下，访问 $user->getProfile() 会触发额外 SQL 查询（懒加载）。若需一次性查出用户+档案，应在 Repository 中用 leftJoin：
{
$qb = $this->createQueryBuilder('u');
return $qb
->leftJoin('u.profile', 'p')
->addSelect('p')
->where('u.id = :id')
->setParameter('id', $id)
->getQuery()
->getOneOrNullResult();
}
这里 addSelect('p') 是关键，它把 Profile 实体也纳入结果，避免后续调用 getProfile() 再查库。
