Medusa v2.21.1：引入 Search Module 与多项修复

Search Module

Medusa v2.21.1 新增 Search Module，用于管理并检索应用内定义的索引。除产品外，也可以通过为某个数据模型定义索引来搜索该模型。

模块支持接入搜索引擎的提供方（provider）。官方给出的两种是：PostgreSQL Search Module Provider，以及面向 Medusa Cloud 用户的 Medusa Search。

索引以 defineSearchIndex 定义，可声明实体、字段与事件。字段可用 search 辅助方法标注为可过滤、可搜索（含权重）、可分面，或以对象数组形式嵌套关联数据。示例中的产品索引监听了 product.created、product.updated、product.deleted 三个事件，并配置了 graphConsume 与 graphSeed。启用后可通过新的 /store/search API 路由发起店面搜索。

官方另提供了从 Algolia、MeiliSearch 迁移至 Search Module 的指南。

忠诚度插件

• 可在管理后台对商店积分账户进行扣款。
• 可在管理后台的客户详情页直接创建商店积分账户。

其他变化

• 管理后台新增芬兰语与瑞典语翻译，土耳其语翻译补齐 306 个缺失键，克罗地亚语翻译得到更新。
• 认证：无 actor 的身份重复注册时须使用相同密码；默认 http.authMethodsPerActor 值正确生效，/auth/:auth_provider/user 路由受配置控制。
• 无待付金额或客户为访客时，禁用商店积分支付选项。
• 订单列表查询包含 shipping_address，使国家列正常显示。
• step 补偿函数中的变更会被正确 await；启用 manage_inventory 时创建库存项。
• Postgres 搜索提供方会过滤向量字段；搜索的 graph 辅助方法支持 load 属性并接收上下文。
• Stripe webhook 签名校验错误不再导致处理器崩溃。
• 店面创建退货时设置 requested_at；通配符缓存清理会重置内部大小计数；deepEqualObj 按时间值比较日期。
• --skip-migrations 标志现在确实跳过迁移；管理后台 Vite 配置去重 react 与 react-dom；构建时 lint 步骤传入 failOnError: false；link-create-keys-modules-enum 规则减少误报；测试钩子失败时记录完整错误对象。

版本发布日期为 2026-09-22。