Symfony本身不提供全文搜索能力，Doctrine的LIKE或MATCH AGAINST在多字段、多语言、高并发下性能差；高效全文搜索需用Elasticsearch，FOSElasticaBundle是Symfony生态最成熟集成方案。
直接上结论：Symfony 本身不提供全文搜索能力，Doctrine 的 LIKE 或 MATCH AGAINST 在多字段、多语言、高并发场景下会迅速成为性能瓶颈；真正高效的全文搜索必须交由专用搜索引擎（如 Elasticsearch）处理，而 Symfony 生态中最成熟、最省心的集成方案是 FOSElasticaBundle。
为什么不能只靠 Doctrine + LIKE 做全文搜索
很多开发者一开始用 $qb->where('p.title LIKE :q')->setParameter('q', "%{$keyword}%")，短期能跑通，但很快会暴露问题：
- 中文、捷克语等带重音字符（如
polykarbonátové）在默认 collation 下无法被LIKE正确匹配，即使做了Normalizer::normalize()，数据库层面仍可能丢字或错位 - 多个
OR条件联合查询（比如同时搜标题、描述、标签）会导致 MySQL 放弃索引，全表扫描 —— 日志里看到EXPLAIN显示type: ALL就是警报 -
JOIN多张表后加LIKE，MySQL 全文索引（MATCH ... AGAINST）基本失效，官方文档明确说明它“不支持 JOIN 中的列” - 没有词干提取、同义词扩展、拼写纠错、搜索高亮等现代搜索必需能力
FOSElasticaBundle 是什么，为什么它是首选
FOSElasticaBundle 不是简单封装客户端，而是把 Elasticsearch 深度嵌入 Symfony 生命周期：自动监听 Doctrine 事件、管理索引别名、支持异步批量同步、提供 Finder 接口屏蔽底层细节。它解决的是“怎么让搜索和业务逻辑不脱节”这个根本问题。
- 安装只需一条命令：
composer require friendsofsymfony/elastica-bundle - 配置后，执行
php bin/console fos:elastica:populate就能把 Doctrine 实体数据一键导入 Elasticsearch - 后续所有实体变更（
INSERT/UPDATE/DELETE）都会触发自动同步，无需手动调$client->index() - 控制器里查搜索结果就像查 Doctrine Repository：
$finder->find('keyword')或$finder->createPaginatorAdapter($query)
如何避免索引与数据库数据不一致
这是集成中最容易被忽略、但后果最严重的一环 —— 索引滞后导致用户搜不到刚发布的数据，或者删掉的内容还能搜出来。
- 默认同步是 实时（realtime） 模式，依赖 Doctrine
postPersist等事件，但如果用了事务、批处理或异步命令，事件可能未触发 - 生产环境务必启用
fos_elastica.persistence.sync: false并配合php bin/console fos:elastica:populate --no-reset --batch-size=500定时补漏 - 对强一致性要求高的场景（如后台审核通过立即可搜），不要依赖事件驱动，改用显式调用：
$persister->insertOne($entity)，并在事务提交后执行 - Elasticsearch 的
refresh_interval默认是1s，意味着新文档最多延迟 1 秒可见；如需近实时，可在索引 settings 中设为"refresh_interval": "30s"（注意资源开销）
搜索中文或带重音语言时的关键配置
Elasticsearch 默认分词器对西欧语言友好，但对中文、斯拉夫语系支持极弱。必须显式配置分析器（analyzer），否则 polykarbonátové pouzdro 会被切成 polykarbon 和 átové 两段，完全失真。
- 在
config/packages/fos_elastica.yaml的 index 配置里加settings块，定义icu_analyzer或smartcn（中文） - 字段映射中指定
analyzer和search_analyzer，例如：title: { type: text, analyzer: icu_analyzer, search_analyzer: icu_analyzer } - 确保 Elasticsearch 已安装对应插件：
bin/elasticsearch-plugin install analysis-icu（ICU 分析器）或analysis-smartcn - 测试分词效果用：
curl -X GET "localhost:9200/_analyze" -H 'Content-Type: application/json' -d '{"analyzer": "icu_analyzer", "text": "polykarbonátové"}'
真正麻烦的从来不是“怎么装”，而是“怎么让搜索结果既快又准还不出错”。Elasticsearch 的 mapping、analyzer、refresh、sync 模式这些点，任何一个配歪了，都会让前端搜不到、搜不准、搜得慢 —— 它们不像路由或表单那样有清晰错误提示，问题往往静默发生。
