diff --git a/changelogs/2026-05/29_fix_mp_product_line_order_align_admin.md b/changelogs/2026-05/29_fix_mp_product_line_order_align_admin.md new file mode 100644 index 0000000..3d49233 --- /dev/null +++ b/changelogs/2026-05/29_fix_mp_product_line_order_align_admin.md @@ -0,0 +1,30 @@ +# 【FYI·小程序】主题下产品列表排序与管理端对齐(前端无需改) + +> **类型**: 后端排序键对齐(fix,后端已改并部署测试服验证通过) +> **服务**: hl-product-service-v2 +> **日期**: 2026-05-29 +> **影响范围**: 小程序端「主题(产品线)详情 → 产品列表」`GET /mp/product-line/{lineId}/products` 的返回顺序 +> **归属**: 后端已修(PR #3228 → dev,#3229 同步 dev-v3) +> **状态**: 已部署测试服并验证通过 +> **关联工单**: #3227 / 跟进 #3215(管理端拖拽排序) + +--- + +## 一、问题 + +管理端给主题下产品排好序后,小程序端展示顺序与管理端不一致。 + +根因:小程序主题详情用的查询只按 `sort_order` 升序,缺管理端的 `create_time` 次序键。当多个产品 `sort_order` 相同(尤其默认全 0、运营还没逐个拖排时),小程序与管理端顺序不一致(实测恰好相反)。 + +## 二、改动(后端已完成) + +小程序主题下产品查询排序键补齐为 `sort_order ASC + create_time DESC`,与管理端「版本列表」完全一致。 + +- 现在:管理端怎么排,小程序就怎么显示(逐个拖排了按拖排顺序;没拖排的按创建时间倒序,与管理端一致)。 +- **前端无需任何改动**,接口字段/结构不变,顺序自然对齐。 + +## 三、测试服实测(主题 2045622604613529601,4 个已上架产品) + +清缓存后,小程序返回顺序与管理端列表完全一致(均为 `875842 → 328770 → 826306 → 046978`);修复前小程序为相反顺序。 + +> 提示:小程序该接口有 10 分钟缓存,管理端重排后最长 10 分钟内生效(重排已触发缓存失效,正常情况即时生效)。