symfony2数据库查询以doctrine orm为核心，构建分层、可测、安全的数据访问体系，涵盖实体映射、dql编译、sql生成、参数绑定与结果映射全流程。
Symfony2 的数据库查询不是“写个 SQL 就行”，而是围绕 Doctrine ORM 构建的一套分层、可测、安全的数据访问体系。它从实体映射出发，经 DQL 编译、SQL 生成、参数绑定，最终完成结果映射——每一步都影响安全性、性能和可维护性。
实体与元数据：查询的起点
Doctrine 不是凭空执行查询，而是依赖实体类上声明的元数据（如 @ORM\Entity、@ORM\Column、@ORM\ManyToOne）。这些注解在应用启动时被解析为 ClassMetadata 对象，包含表名、主键字段、关联关系等全部结构信息。
比如调用 $repo->find(123)，内部会查元数据确认主键列是 id 还是 uid，再生成对应 SQL；JOIN u.posts 能成立，是因为元数据里已定义了 posts 是一个一对多关联属性，并知道外键在 post.user_id。
- 旧库迁移时，必须用
doctrine:mapping:import --force反向生成实体，并显式补全 @ORM\Table(name="xxx") 和 @ORM\Id - 字段类型要精确，如价格用
type="decimal"，状态用字符串枚举而非整数 - 多对多关系需中间表 + 正确的
inversedBy/mappedBy声明，否则 QueryBuilder JOIN 会失败
查询构建：优先级清晰、方式分明
Doctrine 提供多种查询手段，但不是“哪个顺手用哪个”，而是有明确优先级：
-
简单条件查单条/列表：用
findOneBy(['status' => 'active'])或findBy(['type' => 'book'], ['createdAt' => 'DESC'], 10)—— 参数自动绑定，语义清晰，自带缓存 -
带 JOIN、分页、动态条件：统一走
createQueryBuilder()—— 字段写错会在编译时报错，支持链式拼接、expr()构建复杂逻辑，IDE 友好 -
高度复用或业务语义强的查询：封装为 Repository 自定义方法，如
findActiveByPriceRange($min, $max)，不暴露实现细节 -
原生 SQL：仅限跨库、MySQL JSON 函数、或压测确认瓶颈的极少数场景；必须配合
NativeQuery+ 手动字段映射，严禁字符串拼接
禁止在控制器、模板、表单中直接调用 $em->getRepository()->find() 或 createQuery() —— 所有数据获取必须收口到 Repository 或 Service 层。
关联加载：一次查对，拒绝 N+1
N+1 的本质是“该一次性取的没取，等用的时候才懒加载”。解决它不是关掉懒加载，而是主动控制加载时机和内容：
- 需要关联数据时，必须显式
leftJoin('u.posts', 'p')并紧跟addSelect('p.title', 'p.createdAt')，否则 Doctrine 仍按代理对象处理 - 禁用
fetch="EAGER"—— 它无法按接口粒度控制，容易拖垮性能；改用按需封装的方法，如findUsersWithLatestPosts() - 只读统计类场景（如销量榜），优先用数据库视图 + 只读实体：
@ORM\Entity(readOnly=true)，在 Repository 中用 DQL 查询视图字段，不 join、不 hydrate 实体 - 开发环境用 Web Profiler 的 Database 面板快速识别：若 SQL 条数远超主查询记录数，且出现大量结构相似的
SELECT * FROM post WHERE user_id = ?，就是典型 N+1
安全与健壮：参数绑定、空值处理、缓存策略
查询安全不是靠“别传恶意字符串”，而是靠机制保障；健壮性也不是靠 try-catch，而是靠前置约束：
- 所有外部输入（路由参数、表单、查询字符串）必须通过
setParameter()或数组参数传入，findOneBy(['slug' => $request->query->get('s')])安全，"WHERE s.slug = " . $s直接禁用 - 查不到数据不能依赖返回
null判断，应在 Repository 方法中显式处理语义，如return $result ?: throw new UserNotFoundException() - 缓存不是全开，而是按场景分级：主键查（
find($id)）自动缓存键entity:User:123；固定条件单条（findOneBy(['slug' => $s])）可缓存；动态搜索类查询一般不缓存 - 缓存失效用版本号（如
cache_version_user: 3）而非删除，避免并发穿透；禁用 Doctrine 默认 Query Cache，专注用 APCu 或 Redis 存结果数组
