Sap Commerce(hybris)内容目录同步后搜索页不显示产品求助

1. 前端模板渲染逻辑检查 #

• 核对搜索结果页面的JSP/Thymeleaf模板，确认遍历Solr返回产品列表的循环逻辑是否正确：比如循环变量名是否与后端传递的参数匹配，是否存在错误的条件判断（如误加if (product.stock > 0)过滤了所有无库存产品）。
• 打开浏览器控制台，检查是否存在JS报错，这类错误可能导致DOM渲染失败，进而无法展示产品列表。
• 确认模板中引用的产品属性是否存在，若引用了已废弃或未配置的属性，会导致单个产品项渲染失败，最终整个列表无法显示。

2. Solr返回字段完整性验证 #

• 通过Solr Admin Console执行相同搜索查询，检查返回的每个产品文档是否包含前端渲染必需的属性（如code、name、thumbnail等）。若关键属性缺失，模板无法生成产品项。
• 检查Solr索引配置（solr.impex或后台Solr Facet Search配置），确保对应内容目录的索引类型包含所有前端需要的字段，且字段已设置stored="true"。

3. 内容目录同步与版本校验 #

• 确认内容目录同步后，在线版本（Online Catalog）的产品处于激活状态。搜索页面默认读取在线版本数据，若产品未激活，即使Solr已索引，前端也会过滤这类产品。
• 检查内容目录同步任务的执行日志，确认是否有产品在同步过程中被遗漏，或同步后的产品版本与Solr索引的版本不匹配（如Solr索引了旧版本产品，而在线版本为新版本但属性映射错误）。

4. 自定义搜索逻辑排查 #

• 检查项目中是否存在自定义的SolrQueryPostProcessor或SearchResultInterceptor，这类自定义逻辑可能在查询后过滤了所有产品，导致前端仅能看到总数但列表为空。
• 查看Hybris后台日志（hybris/log/tomcat/localhost.log）和Solr日志（solr/server/logs/solr.log），排查是否有拦截器执行时的异常（如空指针）导致结果被清空。

5. 缓存与会话清理 #

• 清除Hybris系统缓存（后台按F4，或执行ant clean all后重启服务），同时清除浏览器缓存，避免旧缓存导致的显示异常。
• 检查搜索结果相关的缓存配置（如cache.region.searchResults），确认缓存过期时间是否合理，防止更新后的索引未被及时读取。

6. 权限配置检查 #

• 确认当前访问用户所属的用户组是否有对应产品的查看权限。若产品设置了特定权限组，而当前用户无权限，前端会隐藏产品列表项，但Solr仍会返回总数（权限过滤通常在前端或服务端后续逻辑中执行）。

内容的提问来源于stack exchange，提问作者Ciccio Cappuccio