Doctrine默认惰性加载使集合看似为空并非Bug，而是代理机制所致：$client->getTemplates()返回未初始化的PersistentCollection，count()为0且toArray()为空，仅在遍历、isInitialized()或first()等操作时触发SQL查询；应避免fetch="EAGER"，改用Repository层显式JOIN查询（如findClientWithTemplates）、合理配置Redis标签缓存及URL编码连接参数以解决N+1与性能问题。
Doctrine默认惰性加载为什么让集合看起来是空的
这不是Bug，是Doctrine的代理机制在起作用。当你调用$client->getTemplates()时，返回的是PersistentCollection对象，initialized属性为false，count()返回0，toArray()也为空——但数据库里其实有数据。只有真正遍历或调用isInitialized()、triggerEagerLoad()时才会发起SQL查询。
- 别用
fetch="EAGER"：它会让所有关联无条件加载，N+1变成1次大查询，内存暴涨且无法按需控制 - 显式触发加载只在必要时做：
$client->getTemplates()->first()或$client->getTemplates()->count()会拉取数据，但要注意这仍是单条SQL，不是批量优化 - 真正要解决性能问题，得绕过这个代理机制，用Repository层主动查
用Repository自定义查询替代隐式关联访问
把“查Client再查Templates”这种两步操作，合并成一条带JOIN的查询，是消除N+1最直接的方式。关键不是写SQL，而是用QueryBuilder构造可复用、可测试的逻辑。
- 在
ClientRepository里加方法：public function findClientWithTemplates(int $id): ?Client - 用
$qb->select('c, t')->leftJoin('c.templates', 't')显式JOIN，避免getTemplates()触发额外查询 - 如果模板还要分页或过滤，直接在JOIN后加
->where('t.status = :status')和->setParameter('status', 'active') - 不要在Controller里拼
createQueryBuilder()——逻辑下沉到Repository，方便单元测试和缓存复用
查询结果缓存必须配Redis + tag-aware适配器
Doctrine的result_cache_driver默认关着，光配cache.yaml没用，还得在Query级别手动启用。否则缓存根本不会生效。
- 配置里必须用
cache.adapter.redis_tag_aware：普通Redis适配器不支持按实体类型批量失效，改了User数据却清不掉所有User查询缓存 - 代码里要显式调用：
$query->useResultCache(true, 3600, 'client_with_templates') - 缓存键名建议带参数哈希，比如
'client_'.$id.'_with_templates'，避免不同ID共用同一缓存项 - 别用
cache.adapter.php_files上生产——文件锁+磁盘IO在并发下会成为瓶颈，哪怕只是过渡也不推荐
云环境连接参数错一个字符就超时
本地跑得飞快，一上云就慢半秒甚至超时，大概率是DATABASE_URL里的细节没对齐。Doctrine不报错，但底层PDO连接卡在DNS解析或TCP握手阶段。
- 主机名不能写
localhost：云服务器走的是网络栈，localhost会尝试Unix socket，失败后才降级到TCP，白白浪费50–200ms - 密码含
@、/、:必须URL编码：比如pa@ss/word要写成pa%40ss%2Fword，否则parse_url()截断连接串 - 加PDO选项强制UTF8MB4：
?charset=utf8mb4&serverVersion=8.0，避免字符集隐式转换拖慢查询 - 设置连接超时：
&connect_timeout=5，防止数据库暂时不可用时整个请求挂住
