API Changelog Bot 1aee259ee3 docs: 撤回 09_frontend_notice_admin_product-share-remove-target-user-step (基于过时 hl-ui 本地版本的误判,master 上无该问题)

2026-05-09 16:08:31 +08:00

7.0 KiB

原始文件 Blame 文件历史

⚠️ 本通知已撤回(2026-05-09 由 wx 撤回)

撤回原因

本通知发布时基于 BUG 分析员第一轮调研的错误结论 — 当时本地 hl-ui 仓库落后远程 master 225 commits 没有 fetch,看到的不是最新代码。第二轮调研拉远程最新版后发现:

远程最新 gitea/master 的 MiniappShareModal.vue 自始至终就是直接生成 scheme,没有任何"选目标用户"UI 或前置步骤

最近 225 个 commit 中只有 2 处分享相关改动,均非破坏性(路径按 productType 分流 / query 拼 adminId)

用户实测确实多了"选用户"步骤,但与 master 代码不符 — 当前推测是用户访问的环境部署版本不是最新

请前端 mmg 注意

暂时不要按本通知去删除任何"选用户"相关代码 — 那个代码在 master 上根本不存在,你删不到东西

真根因还在排查(用户测试的环境到底跑的哪个版本),后续会发新一条 changelog 给出准确指引

给你添麻烦了,这是管理者(我)第一轮没让 BA 强制 fetch 的失误

(以下为原通知,内容作废,仅留作历史档案)

前端 BUG 通知 — admin 产品分享去掉"选目标用户"步骤,直接生成 URL Scheme

日期: 2026-05-09 类型: 前端 BUG (admin 后台 hl-ui) 模块: 产品管理 → 产品列表 → 分享按钮 (MiniappShareModal) 通知: @mmg 后端是否需改动: 否(后端接口契约自 PR #1488 上线起从未变,不需要、也不应该加 targetUserId 字段) 严重性: 中 — 多余步骤,影响 admin 操作效率

现象

入口: admin 后台 → 产品列表 → 列表行「分享」按钮 (hl-ui/src/views/product/list/components/MiniappShareModal.vue)

期望流程: 点「分享」→ 前端组装 path + query → 直接调后端接口 → 拿到 weixin://dl/business/?t=xxx URL Scheme 短链 → 弹窗里展示给 admin 拷贝/转发

当前流程 (bug): 点「分享」→ 弹出"选目标用户"列表/搜索框 → admin 选完一个用户后才生成链接

→ "选目标用户"这一步是多余的,后端接口里完全没有"目标用户"概念,该步骤可直接删掉。

根因 (后端代码反推)

后端接口 POST /admin/wxapp/share/url-scheme 自 PR #1488 (2026-04-27) 上线以来,代码从未改过 — 见 hl-user-service/src/main/java/com/hulalv/user/controller/AdminWxappShareController.java:61-72。

入参 VO WxappUrlSchemeReqVO (hl-user-service/src/main/java/com/hulalv/user/vo/admin/WxappUrlSchemeReqVO.java) 完整字段清单:

字段	类型	必填	说明
`path`	String	✅	小程序页面路径(不带前导 `/`)
`query`	String	❌	querystring,如 `id=123&sharerId=456`
`envVersion`	String	❌	release / trial / develop,不传走配置默认
`expireDays`	Integer	❌	1-365 天,默认 30

注意: 完全没有 targetUserId / receiverId / userId / shareTo 等"目标用户"字段。

后端 Service 实现 (WechatMiniAppClient.generateUrlScheme) 是对微信开放平台 wxa/generatescheme API 的纯翻译调用,接口语义上与"分享给谁"无关 — 生成的是一条任何人点开都能进对应小程序页面的 scheme 短链。

→ "选目标用户"步骤是前端 UI 单方面加的,后端没有任何对应字段或逻辑。即便前端额外传了 targetUserId,后端 VO 没声明,Spring 反序列化会忽略,最终不会进入业务逻辑。

期望前端做的事

修改文件: hl-ui/src/views/product/list/components/MiniappShareModal.vue

优先级 1: 去掉"选目标用户"那一步弹窗 / 用户列表 / 搜索逻辑(以及对应的状态变量、watch、API 调用)

优先级 2: 改回直接组装 path + query 调后端接口,拿到 link 字段后展示给 admin 拷贝/转发

后端接口契约 (前端复核用)

`POST /admin/wxapp/share/url-scheme`

Headers:

Content-Type: application/json
Authorization: Bearer <admin token>

Request body:

{
  "path": "pages/product/detail/detail",
  "query": "id=123&sharerId=456",
  "envVersion": "release",
  "expireDays": 30
}

⚠️ 字段约束:

path 必填,不带前导 /,长度 ≤ 256

query 可选,长度 ≤ 1024

envVersion 可选,仅接受 release / trial / develop,不传走配置默认

expireDays 可选,范围 1-365,不传默认 30

Response Result<WxappUrlSchemeRespVO>:

{
  "code": 200,
  "message": "成功",
  "success": true,
  "data": {
    "link": "weixin://dl/business/?t=abc123",
    "expireTime": 1735689600
  }
}

字段	类型	说明
`data.link`	String	scheme 短链,直接给 admin 拷贝
`data.expireTime`	Long	Unix 秒级过期时间戳,微信未返回时为 null

响应结构与现有前端调用完全一致,前端无需改取值代码。

后端为什么不需要(也不应该)加 `targetUserId`

有人可能会想:既然 UI 上有"选目标用户"步骤,要不要后端也加个 targetUserId 字段记录一下?不行:

微信 wxa/generatescheme API 本身不接受"目标用户"参数 — scheme 短链是公开的,任何人点开都能进同一个小程序页面
如果业务需要"哪个用户分享给哪个用户"的归属关系,应该在 query 里塞 sharerId / targetUserId 当作小程序页面参数(前端组装 query 时自定),而不是后端 VO 加字段
加字段反而会带来"前端必传 → 不传 400"的破坏性变更

→ 后端接口契约保持原样,零改动。

复现取证 (mmg 在 DevTools 验证)

Network: 抓「分享」按钮触发的请求,确认目标接口 POST /admin/wxapp/share/url-scheme
Payload: 看请求 body 里是否多塞了 targetUserId / receiverId 之类后端 VO 不存在的字段(后端会忽略,但是冗余)
Sources: 搜 MiniappShareModal.vue,定位"选目标用户"那段 UI 与逻辑代码,整段移除

验收

mmg 修完前端后,验收点:

admin 产品列表点「分享」按钮 → 弹窗里直接显示 scheme 链接(weixin://dl/business/?t=xxx),不再有"选目标用户"那一步
弹窗加载完成后,链接可一键拷贝
不同产品行点分享,生成的 link 携带不同 productId(query 字段里的 id 正确)
后端接口 round-trip 状态码 200,响应结构与上方契约一致

涉及文件

前端 (mmg 修改):

hl-ui/src/views/product/list/components/MiniappShareModal.vue

后端 (零改动,仅供前端复核):

hl-user-service/src/main/java/com/hulalv/user/controller/AdminWxappShareController.java:61-72
hl-user-service/src/main/java/com/hulalv/user/vo/admin/WxappUrlSchemeReqVO.java
hl-user-service/src/main/java/com/hulalv/user/vo/admin/WxappUrlSchemeRespVO.java

7.0 KiB 原始文件 Blame 文件历史

⚠️ 本通知已撤回(2026-05-09 由 wx 撤回)

撤回原因

请前端 mmg 注意