fix: 分享到小程序 URL Link / URL Scheme 404 已修复

日期: 2026-04-27 PR: #1488 (Closes #1481) 类型: BUG 修复 — 前端零改动, 自动生效 影响端: 管理后台 (admin) — 产品列表「分享到小程序」对话框

修复内容

之前的问题

蒋雨莲 (橙子) 在产品列表点「分享到小程序」 → 弹对话框 → 点「URL Link 生成」或「URL Scheme 生成」按钮:

顶部弹红色 toast: 请求的资源不存在(HTTP 404)
DevTools Network 面板: 两次 url-link 请求 status=404

根因

后端完全没实现 admin 端点, 前端 MiniappShareModal.vue 已上线但从未与后端联调。与 #1477 cost-item 同款「前端先发后端漏跟」模式。

修复

后端补齐 2 个端点 + hl-gateway 加路由:

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

Request body (两端点一致):
{
  "path": "pages/product/detail/detail",   // 必填
  "query": "id=20457...",                   // 选填
  "envVersion": "trial" | "release",        // 选填, 默认 release
  "expireDays": 30                          // 选填, 默认 30 天
}

Response:
{
  "code": 200,
  "message": "成功",
  "data": {
    "link": "https://wxaurl.cn/..." | "weixin://...",   // URL Link 是 https, URL Scheme 是 weixin://
    "expireTime": 1735689600                            // 过期 Unix 时间戳
  }
}

字段统一

URL Link 和 URL Scheme 响应字段都叫 link(微信原始 urlLink/openlink 已在后端归一化), 前端 MiniappShareModal.vue:223,242 取值 res.link || res 完全兼容。

前端动作

必须 ✅

无。hl-ui/src/api/wxapp.js 中 generateUrlLink / generateUrlScheme 调用方式不变, 后端补齐端点 + 网关路由后自动工作。

验收 ✅

测试服管理后台:

用 SUPER_ADMIN 登录(或任意 admin token)
进「产品线管理」→ 任一产品列表
点产品上的「分享到小程序」按钮
在弹窗里点「URL Link 生成」 → 应填充 https://wxaurl.cn/... 类链接
点「URL Scheme 生成」 → 应填充 weixin://... 类链接

测试服已部署 hl-user-service + hl-gateway 完成 (2026-04-27 16:51)。

⚠️ 测试服可能仍报 230506 (errcode=40001)

后端代码 + 路由 + 调用链已就绪, 但测试服微信 appid 鉴权可能未配齐(测试小程序 IP 白名单 / 接口权限 / appid-secret 不匹配)。如测试服仍报错:

{"code":230506, "message":"生成分享链接失败(错误码:40,001)"}

这不是代码 bug, 是微信开放平台账号配置侧。运维需确认:

nacos wechat.miniapp.appid / secret 与测试小程序后台一致
测试服出口 IP 116.117.149.79 在小程序后台 IP 白名单
测试小程序已开通 generate_urllink + generatescheme 接口权限

正式服 appid/secret/IP 白名单配置正确即可工作。

参考路径

端	文件	行
前端 API	`hl-ui/src/api/wxapp.js`	3-18
前端组件	`hl-ui/src/views/product/list/components/MiniappShareModal.vue`	213, 232
后端 (新)	`hl-user-service/.../controller/AdminWxappShareController.java`	`@RequestMapping("/admin/wxapp/share")`
后端 wxa 客户端	`hl-user-service/.../service/WechatMiniAppClient.java`	generateUrlLink + generateUrlScheme
网关路由 (新)	`hl-gateway/src/main/resources/application.yml`	`Path=/admin/wxapp/**` → `lb://hl-user-service`

关联

反馈人: 蒋雨莲 (橙子) 2026-04-27
后端 changelog: hl-backend-changelog/changelogs/2026-04/2026-04-27_user_admin-wxapp-share-endpoints.md

3.6 KiB 原始文件 Blame 文件历史