Medusa v2.21.2：搜索路由限制返回字段以提升性能

Medusa v2.21.2 于 2026 年 9 月 28 日发布，发布说明的主要变化集中在搜索路由。

搜索行为调整

/store/search 路由现在只允许检索搜索索引中已定义的字段，不再允许通过 query.graph 预先加载并返回索引以外的数据。发布说明称此调整用于改善搜索性能，并要求开发者明确声明索引数据模型上可被检索的内容。相关修复由 @sradevski 在 #17044 提交。

同版本其他修复

• 搜索相关：设置或失效缓存前等待缓存稳定；避免搜索索引版本不断堆积。
• 促销：使自动促销的预筛选条件与候选促销对应。
• 管理端产品更新：允许省略已弃用的选项。
• Redis 工作流引擎：将 RedisWorkflowsOptions 嵌套到模块选项类型中的 redis 下。
• 支付：避免对已带 pp_ 前缀的 provider 重复添加前缀。
• 草稿订单：修复选择无邮箱客户时管理端崩溃。
• CORS 来源处理：在 buildRegexpIfValid 中去除 g/y 标志。
• 仪表盘：修复订单支付标签国际化、补全若干语言缺失键、创建区域表单增加可读校验信息、修正退款与退货原因行链接、配送配置文件行链接等。

文档与本地化

文档方面新增取消工作流执行、allow unauthenticated 行为、has_account 含义与访客客户转注册客户等内容，并更新 Cloud 与搜索相关说明。仪表盘补全了越南语、乌克兰语、希腊语、马其顿语、匈牙利语等本地化条目。

本次发布为补丁版本，未在说明中给出破坏性变更的迁移步骤；升级前仍应核对搜索字段定义是否覆盖现有查询需求。