65 行
3.8 KiB
Markdown
65 行
3.8 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "7263"
|
||
title: "大期数团期产品（存活班期 ≥ 约 260 期）库存/已报名/有效订单数/展示态由静默错值恢复为准确值（无接口、字段、路径、参数变化）"
|
||
consumer: "multiple"
|
||
author: "jw(GIT)"
|
||
change_type: "修复"
|
||
backend_status: "deployed"
|
||
gateway_status: "verified"
|
||
frontend_status: "not_required"
|
||
frontend_owner: ""
|
||
frontend_ref: ""
|
||
target_release: ""
|
||
verified_at: ""
|
||
status_note: "纯后端修复(PR #7268 合入 dev-v3,squash f1eb72444),不动接口/字段/路径/参数/枚举/错误码,仅让大期数(≥约260期)GROUP 产品库存类字段由错变对。前端 mmg 已实查为 not_required:前端读 sellable 判可订、enrolledPeople/remainStock/orderCount 显示,全部为读后端值直接用、无前端兜底/反推逻辑;后端值由错变对,前端显示自动改善,无需改码。"
|
||
updated_at: "2026-09-07"
|
||
base: "dev-v3"
|
||
---
|
||
|
||
# 大期数团期产品库存字段静默降级修复（修复）
|
||
|
||
## 一、给前端的一句话
|
||
|
||
**前端无需任何改动。** 本次修复不动接口、不动字段、不动路径、不动参数、不动枚举、不动错误码，只是让**存活班期数很多（约 260 期以上）的 GROUP 团期产品**，其库存类字段从「悄悄算错」恢复为「算对」。字段还是原来那些字段，结构一模一样，只是数值变准了。
|
||
|
||
## 二、症状（改前）
|
||
|
||
product-v2 聚合 order-v3 活跃订单数时，把该产品**全部班期 ID** 一次性拼进一个 GET 请求的 query string。当存活班期 ≥ 约 260 期时，请求行超过 order-v3 内嵌 Tomcat 默认 `max-http-header-size`（8192 字节），order-v3 在协议层直接拒收，product-v2 侧把它当成「无活跃订单」降级——**接口仍返回 HTTP 200**，但下面这些字段悄悄退化为只含线下占位值：
|
||
|
||
- 管理端班期列表 / 统一价格日历：`orderCount`、`enrolledPeople`、`remainStock`、`remainParticipants`、`sold`、`bookedRooms`、`sellable`、`batchStatus`
|
||
- 小程序班期列表 / 价格日历 / 最早可售日 / 产品详情：`enrolledCount`、`remainFamilies`、`remainParticipants`、`batchStatus`、`isSelectable`、`remainStock`、`isBooking`
|
||
- order-v3 团期看板经 internal 详情合并的库存类字段
|
||
|
||
后果：满员班期可能显示为「可选 / 可订」，运营选完才被创单侧拒、用户点进去才发现无名额；小程序侧还会把错值缓存 5 分钟。
|
||
|
||
## 三、修复（改后）
|
||
|
||
聚合改为在 product-v2 内部按**每片 ≤100 个班期 ID** 分片串行调用 order-v3、内存合并，任意期数都不再超限。**响应契约完全不变**，只是数值恢复准确。
|
||
|
||
## 四、受影响接口（全部「复用不改」，仅数值由错变对）
|
||
|
||
| 端 | 接口 |
|
||
|---|---|
|
||
| 管理后台 | `GET /admin/product/item/:id/schedule/list` |
|
||
| 管理后台 | `GET /admin/product/item/:id/pricing-calendar` |
|
||
| 管理后台 | `GET /admin/product/item/order-picker` |
|
||
| 小程序端 | `GET /mp/product/:id/schedules` |
|
||
| 小程序端 | `GET /mp/product/:id/price-calendar` |
|
||
| 小程序端 | `GET /mp/product/:id/earliest-available-date` |
|
||
| 小程序端 | `GET /mp/product/:id` （`isBooking`） |
|
||
|
||
以上接口的 method、path、入参、出参字段、枚举、错误码**均无变化**，前端调用方式、类型定义、渲染逻辑一律不用改。
|
||
|
||
## 五、影响范围
|
||
|
||
- 只影响存活班期数很多（约 260 期以上）的 GROUP 产品；期数较少的产品改前改后表现一致。
|
||
- 二期尚未上生产，本修复当前只作用于测试环境及二期上线后随班期累积而到来的将来。
|
||
- 后端只滚 `hl-product-service-v2`，order-v3 / 网关 / 其它服务不动。
|
||
|
||
## 关联 / 联系人
|
||
|
||
- 工单：https://git.1814.love:8443/wx/HL/issues/7263
|
||
- PR：https://git.1814.love:8443/wx/HL/pulls/7268 （squash f1eb72444 合入 dev-v3）
|
||
- 后端：jw
|