Doctrine ORM 在 Symfony 中需完成配置连接、生成实体并建表、通过 EntityManagerInterface 操作数据三步闭环；任一缺失将导致 find() 返回 null、persist() 报 SchemaException 或服务注入失败。
Doctrine ORM 在 Symfony 里不是“装上就能用”，而是必须完成三步闭环：配置连接、生成实体并建表、通过 EntityManagerInterface 操作数据；漏掉任一环，find() 返回 null、persist() 报 SchemaException 或服务注入失败都是必然结果。
数据库连接配不对，EntityManager 根本初始化不了
连接失败不是报错“连接被拒绝”，而是后续所有依赖 doctrine.orm.default_entity_manager 的服务（比如控制器里自动注入的 EntityManagerInterface）直接无法加载，抛出 ServiceNotFoundException 或容器编译错误。
-
DATABASE_URL必须写在.env里，格式严格为mysql://user:pass@host:port/dbname?serverVersion=8.0；PostgreSQL 则用postgresql://...，少一个问号或参数名错（如写成server_version）都会让DoctrineBundle解析失败 -
config/packages/doctrine.yaml中doctrine.dbal.url必须写成'%env(resolve:DATABASE_URL)%'，单引号不能丢，否则环境变量不展开 - MySQL 8+ 默认认证插件是
caching_sha2_password，PHP 7.4+ 才原生支持；若用旧版 PHP，得在数据库侧执行ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pass';
实体类写了但查不到数据，大概率是没建表或映射没生效
Doctrine 不会自动建表。你写好 Product 类、加了 @ORM\Entity 注解，不代表数据库里真有 product 表——此时调用 $em->find(Product::class, 1) 会静默返回 null，而不是报错。
- 运行
php bin/console make:entity Product生成类后，必须立刻跑迁移：php bin/console make:migration→php bin/console doctrine:migrations:migrate - 检查
src/Entity/Product.php是否含@ORM\Table(name="product")；若省略，Doctrine 默认用类名小写（product），但如果你手动改过表名或用了下划线命名（如product_item），就必须显式声明，否则 DQL 查询找不到表 -
auto_mapping: true要开启，否则 Doctrine 不扫描src/Entity/目录；关掉后即使类存在，make:repository也会提示 “Class Product is not a valid entity”
EntityManagerInterface 怎么用才不踩坑
它不是 PDO 封装，而是完整生命周期管理器。直接调 persist() 不 flush()，数据根本不会进库；反过来，flush() 前没 persist()，它也不知道你要存啥。
- 新增：必须两步——
$em->persist($product)+$em->flush()；只做前者，对象只是被 EntityManager “盯上”，还没落地 - 查询：别用
find()查带关联的字段，它默认不加载关联实体（懒加载）；要一次性拿到User和其Profile，得用getRepository(User::class)->findOneBy(['id' => 1], ['profile' => 'INNER JOIN'])或 QueryBuilder 显式leftJoin() - 更新：改完属性后仍需
$em->flush()；Doctrine 跟踪的是对象状态，不是 SQL 变更，所以不调flush()就没更新 - 删除：用
$em->remove($product)+$em->flush()；千万别直接DELETE FROM product WHERE id = ?，否则监听器（如preRemove）和级联逻辑全失效
Repository 不是可选配件，而是避免逻辑污染的关键隔离层
把 WHERE status = 'active' AND created_at > ? 这种条件硬写在控制器里，下次加个排序或分页就得重写一遍；而且测试时没法 mock 查询逻辑。
- 运行
php bin/console make:repository ProductRepository后，在ProductRepository里写方法，比如findByActiveAndRecent(\DateTimeInterface $since) - 方法体内用
$this->createQueryBuilder('p')构造，别拼字符串；QueryBuilder 自动参数化，防注入，也方便单元测试 - 控制器里只写
$products = $this->productRepository->findByActiveAndRecent($date)；Repository 返回实体数组，不是原始数组，保持类型安全 - 别在 Repository 里调
$em->flush()；它只负责“查”，不负责“改”，改操作留在 Service 或 Controller 层更清晰
最常被忽略的一点：Doctrine 的变更跟踪只作用于被 find() 或 persist() 过的对象。你 new 一个 Product，set 了 name，但没 persist()，那它就只是个普通 PHP 对象，$em->flush() 对它完全无效——这个边界，比 PDO 的 prepare/execute 更隐蔽。
