101 行
3.6 KiB
Markdown
101 行
3.6 KiB
Markdown
# 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` 调用方式不变, 后端补齐端点 + 网关路由后自动工作。
|
|
|
|
### 验收 ✅
|
|
|
|
测试服管理后台:
|
|
|
|
1. 用 SUPER_ADMIN 登录(或任意 admin token)
|
|
2. 进「产品线管理」→ 任一产品列表
|
|
3. 点产品上的「分享到小程序」按钮
|
|
4. 在弹窗里点「URL Link 生成」 → 应填充 `https://wxaurl.cn/...` 类链接
|
|
5. 点「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**, 是微信开放平台账号配置侧。运维需确认:
|
|
1. nacos `wechat.miniapp.appid` / `secret` 与测试小程序后台一致
|
|
2. 测试服出口 IP `116.117.149.79` 在小程序后台 IP 白名单
|
|
3. 测试小程序已开通 `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`
|