升级Magento 2.4.6并切换至OpenSearch后分类页异常求助

• 检查分类页默认排序配置
  进入Magento后台，路径Stores > Configuration > Catalog > Catalog > Storefront，确认Product Listing Sort by和Default Product Listing Sort by的设置。如果默认排序字段对应的属性在OpenSearch索引中映射异常，或者排序方向（升序/降序）被设为空值，就会触发该错误。确保排序字段是商品索引中存在的合法属性（如name、price），且排序方向（Asc/Desc）配置完整。

• 排查自定义排序逻辑
  若店铺有自定义排序模块或修改过排序相关代码（比如第三方插件、自定义插件修改分类页排序参数），检查是否在构建OpenSearch查询时传入了空的order参数。重点排查Magento\Catalog\Model\Layer\Category\FilterableAttributeList或其他排序处理类，确认代码未出现排序方向未赋值、传递空字符串给OpenSearch的情况——OpenSearch的SortOrder枚举不接受空值。

• 验证OpenSearch索引字段映射
  登录OpenSearch控制台，查看商品索引（默认是catalog_product_v1）的字段映射，确认你设置的排序字段（如price、position）的类型支持排序（比如float、integer、keyword）。如果字段类型是text且未开启fielddata，或映射格式错误，会导致排序失败。可通过以下命令查看映射：

  curl -X GET "http://your-opensearch-host:9200/catalog_product_v1/_mapping"
  

• 修复排序参数兼容问题
  从ElasticSearch切换到OpenSearch后，Magento 2.4.6的适配可能存在边缘场景问题，部分排序参数格式不兼容。可以尝试调整Magento\Elasticsearch\Model\Adapter\FieldMapper\Product\FieldProvider\SortFieldsProvider类，确保排序方向被强制设置为asc或desc，避免空值传递。如果是第三方模块导致的问题，优先将模块更新到兼容OpenSearch的版本。

• 重建索引并验证数据
  执行完整的索引重建，同时监控过程中是否有错误：

  bin/magento indexer:reindex catalogsearch_fulltext
  bin/magento cache:flush
  

  重建完成后，通过OpenSearch查询验证分类对应的商品是否存在：

  curl -X POST "http://your-opensearch-host:9200/catalog_product_v1/_search" -H "Content-Type: application/json" -d '{
    "query": {
      "term": {
        "category_ids": "你的分类ID"
      }
    }
  }'
  

  如果查询能返回商品，说明索引数据正常，问题出在前端排序请求的参数处理上。

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