Medusa.js中OrderService.list按metadata查询及排序异常问题

仅返回前10条订单的解决方法 #

Medusa 的 OrderService.list 方法默认每页只返回10条数据，要获取更多结果，必须显式传入 pagination 参数，自定义每页数量和偏移量：

const orders = await this.OrderService.list(
  // 查询条件
  {},
  {
    relations: ["billing_address"],
    // 配置分页
    pagination: {
      limit: 50, // 每页返回50条，按需调整
      offset: 0  // 从第0条开始，第二页设为50，第三页100，以此类推
    }
  }
)

如果是大数据量场景，更推荐使用游标分页，避免偏移量分页的性能问题：

pagination: {
  limit: 50,
  cursor: { id: "last_fetched_order_id" } // 传入上一页最后一条订单的ID
}

metadata 查询异常与排序无效的修复 #

1. 修正metadata查询格式 #

直接写 metadata: { status: "711" } 无法正确匹配嵌套字段，必须用点路径语法指定metadata内的键：

const query = {
  "metadata.status": "711"
}

2. 修正metadata排序格式 #

排序时同样要使用点路径指向metadata中的字段，不能直接写 status 或 external_id（会匹配订单模型本身的字段）：

// 假设sortField是"metadata.status"或"metadata.external_id"
const sortConfig = {
  [sortField]: sortOrder // sortOrder 为 "asc" 或 "desc"
}

完整修正代码 #

const orders = await this.OrderService.list(
  {
    "metadata.status": "711"
  },
  {
    relations: ["billing_address"],
    order: {
      [sortField]: sortOrder // 确保sortField是"metadata.status"或"metadata.external_id"
    },
    pagination: {
      limit: 100,
      offset: 0
    }
  }
)

动态多条件metadata查询示例 #

如果需要同时匹配metadata中的多个字段，可以动态构造查询对象：

const query = {};
query["metadata.status"] = "711";
query["metadata.external_id"] = "EXT-12345"; // 额外添加的条件

const orders = await this.OrderService.list(query, {
  relations: ["billing_address"],
  order: {
    "metadata.external_id": "asc"
  },
  pagination: { limit: 50 }
})

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