102 lines
10 KiB
Markdown
102 lines
10 KiB
Markdown
# 2026-07-02 工作日志
|
||
|
||
## 小程序扫码支付"获取订单失败"问题排查与修复
|
||
|
||
- **问题**：用户扫小程序码后进入小程序支付页，提示"获取订单失败"
|
||
- **根因**：后端 Spring Security 的 SecurityConfig 中未将支付相关接口加入白名单(permitAll)，扫码进入时用户未登录态，请求 `/api/app/subscription/detail-by-no/**` 被 401 拦截
|
||
- **修复**：在 SecurityConfig.java 的 antMatchers 中添加了以下接口白名单：
|
||
- `/api/app/subscription/detail-by-no/**` — 根据订阅号查询订单详情
|
||
- `/api/app/subscription/mp-prepay/**` — 创建小程序预支付订单
|
||
- `/api/app/subscription/mp-confirm/**` — 支付成功确认
|
||
- `/api/app/subscription/wx-notify/**` — 微信支付回调通知
|
||
- `/api/wx-login/**` — 小程序码生成等微信登录相关接口（之前只覆盖了 `/api/shop/wx-login/**`，漏掉了 `/api/wx-login/**`）
|
||
- **前端代码位置**：`src/passport/pay/index.tsx`，支付页面从 scene/subscriptionNo 获取订单号，调 detail-by-no 接口
|
||
- **后端代码位置**：`AppSubscriptionController.java`（@RequestMapping("/api/app/subscription"))，`WxLoginController.java`（@RequestMapping("/api/wx-login"))
|
||
- **注意**：生成小程序码时 `envVersion` 默认为 `trial`（体验版），上线前需改为 `release`
|
||
|
||
### 后续排查：后端白名单加了仍报"获取订单失败"
|
||
|
||
- **二次根因**：前端 `src/passport/pay/index.tsx` 的 `fetchDetail` 存在逻辑 bug
|
||
- `request()` 默认 `returnRaw=false`，响应拦截器对 `code===0` 的响应已自动拆包，只返回 `data` 部分（订阅对象）
|
||
- 但 `fetchDetail` 又检查 `res?.code === 200 || res?.code === 0`，而拆包后的 `res`（订阅对象）没有 `code` 字段
|
||
- 因此条件永远为 `false`，走进 `setErrorMsg` 分支，显示"获取订单失败"
|
||
- **修复**：移除多余的 `code` 检查，`request` 成功即代表业务成功，直接使用返回的 `data` 对象；错误由 catch 处理
|
||
- **附加**：`getSubscriptionNo` 加了 `console.log` 打印页面参数和解析结果，方便真机调试排查 scene 传入问题
|
||
|
||
### 五次排查：getOpenId 返回 success:true 但 openid 为 undefined
|
||
|
||
- **根因**：前端 `src/api/passport/wx-login/index.ts` 的 `getOpenId` 函数错误地假设后端返回的是 `{ openid, unionid, session_key }` 对象，直接取 `res.data.openid`；但后端 `/wx-login/getOpenId` 实际返回的是 `LoginResult` 结构 `{ access_token, user }`，真正的 openid 在 `user.openid` 里
|
||
- **修复**：更新 `getOpenId` 类型为 `ApiResult<WxLoginResult>`，从 `res.data.user?.openid` 提取 openid，同时把 `access_token` 和 `user` 一起返回给调用方复用
|
||
- **后续影响**：`handlePay` 中拿到 openid 后，因为 `getOpenId` 已经自动注册/登录（后端会注册新用户并签发 token），理论上用户已经自动登录，可能无需再调 `loginByOpenId`；但当前代码保留双保险
|
||
|
||
- **根因**：`handlePay` 流程有 bug——调了 `Taro.login()` 获取 code，但没有用 code 去换 openid，直接从 `Taro.getStorageSync('openid')` 读取（扫码用户可能没登录过，storage 里没存）
|
||
- **前端修复**（`src/passport/pay/index.tsx`）：
|
||
1. 引入 `getOpenId` 和 `loginByOpenId` API
|
||
2. `handlePay` 中：`Taro.login()` → `getOpenId(code)` 换取 openid → 缓存 openid
|
||
3. 尝试 `loginByOpenId` 自动登录获取 token（如果用户未注册，弹出引导登录对话框）
|
||
4. `mp-prepay` 请求也加了 `returnRaw: true` 和调试日志
|
||
- **后端修复**（`AppSubscriptionController.java`）：
|
||
1. `mp-prepay`：将 `userId == null || !userId.equals(sub.getUserId())` 改为 `userId != null && !userId.equals(sub.getUserId())`，允许未登录用户发起支付
|
||
2. `mp-confirm`：同理，未登录时跳过 userId 校验，用 `effectiveUserId = userId != null ? userId : sub.getUserId()` 替代原 `userId`
|
||
|
||
- **修改点1**：`src/passport/pay/index.tsx` 的 `fetchDetail` 改为 `returnRaw: true`，拿到接口完整响应（含 code/message/data），手动判断业务状态码（`code === 0 || code === 200`），不再依赖拦截器拆包
|
||
- **修改点2**：`fetchDetail` 和 `getSubscriptionNo` 加了详细 console.log/console.error，打印：
|
||
- 原始页面参数（scene、subscriptionNo）
|
||
- 请求 URL 和当前 token
|
||
- 接口完整返回 JSON
|
||
- catch 中的 err.name/type/code/message/data
|
||
- **修改点3**：`src/utils/request.ts` 响应拦截器去掉了 `process.env.NODE_ENV === 'development'` 条件限制，所有环境都打印日志，方便真机调试 Console 查看
|
||
### 六次排查：getOpenId 返回 success:true 但 openid 为 null
|
||
|
||
- **现象**：前端 `getOpenId` 返回 `success: true, access_token: 有值, user.userId: 35619`，但 `openid: null, unionid: null`
|
||
- **根因**：后端 `/wx-login/getOpenId` 虽然通过微信 `jscode2session` 换到了 openid，但**没有把 openid 设置到 `UserParam` 中**。
|
||
- 后续 `userService.getByOauthId(userParam)` 查找用户时，userParam.openid 为空，可能无法命中已有用户；
|
||
- 新用户注册时走 `addUser(userParam)`，而 `addUser` 只在 `userParam.openid` 非空时才会写 `User.openid`，所以新用户 openid 也为空；
|
||
- 对于已存在但 openid 为空的老用户（如手机号注册），直接返回，openid 仍然是 null。
|
||
- **修复**（`WxLoginController.java` 的 `/getOpenId` 方法）：
|
||
1. 从微信返回中拿到 `openid`/`unionid` 后，立即 `userParam.setOpenid(openid)` 和 `userParam.setUnionid(unionid)`；
|
||
2. 用户已存在但 `user.openid` 为空时，把 openid/unionid 更新到数据库并返回最新 user；
|
||
3. 这样 `LoginResult.user.openid` 一定有值，前端就能正确获取并传给 `mp-prepay`。
|
||
### 七次排查：mp-prepay 报 SIGN_ERROR（签名错误）
|
||
|
||
- **现象**：前端调用 `/api/app/subscription/mp-prepay/{id}` 时，后端返回 `code: 1, message: "微信支付服务异常: 微信错误码: SIGN_ERROR, 签名错误"`。
|
||
- **排查**：
|
||
1. 当前小程序 JSAPI 支付使用 `WxNativePayUtil.getConfig` 构建微信支付 Config，模式为 `RSAPublicKeyConfig`（公钥模式），但生产环境 `wechatpay-public-key-id` 为空。
|
||
2. 读取项目下所有证书文件，用 openssl 检查各证书对应的商户号，发现：
|
||
- `/wechat/websopy/apiclient_cert.pem`：商户号 `1557418831`（与小程序无关联）
|
||
- `/wechat/10398/apiclient_cert.pem`：商户号 `1246610101`（与小程序已关联，见截图）
|
||
3. 配置中的 `mch-id` 是 `1246610101`，但配置的 `private-key-relative-path` 指向 `wechat/websopy/`，导致证书与商户号不匹配，微信返回 `SIGN_ERROR`。
|
||
4. 检查 `10398` 目录证书与私钥匹配性：公钥哈希一致，证书序列号为 `48749613B40AA8F1D768583FC352358E13EB5AF0`。
|
||
- **修复**：
|
||
1. 修改 `WxNativePayUtil.java`：将 `RSAPublicKeyConfig`（公钥模式）改为 `RSAAutoCertificateConfig`（自动证书模式），不再依赖 `wechatpay-public-key-id` 和 `wechatpay-cert-relative-path`。
|
||
2. 修正 `application-dev.yml` 和 `application-prod.yml`：
|
||
- `mch-id`：`1246610101`（保持不变，这是正确的）
|
||
- `merchant-serial-number`：`48749613B40AA8F1D768583FC352358E13EB5AF0`（对应 10398 目录证书）
|
||
- `private-key-relative-path`：`wechat/10398/apiclient_key.pem`
|
||
- `wechatpay-cert-relative-path` 置空（自动证书模式）
|
||
- **待确认**：当前保留的 `api-v3-key: "zGufUcqa7ovgxRL0kF5OlPr482EZwtn9"` 是否属于商户号 `1246610101`，需要用户在微信支付商户后台确认。如果仍报签名错误，需要替换为正确的 APIv3 密钥。
|
||
- **待处理**：生产环境需将 `/Users/gxwebsoft/JAVA/websopy-java/src/main/resources/wechat/10398/apiclient_key.pem` 上传到 `/www/wwwroot/file.ws/wechat/10398/apiclient_key.pem`，并确保该文件可被 Java 进程读取。之前错误上传 `wechat/websopy/` 目录的证书给 1246610101 使用，这是 `SIGN_ERROR` 的真正原因。
|
||
|
||
### 八次排查：SUB202607022056385942 提示"订阅不存在"
|
||
|
||
- **现象**：调用 `/api/_app/subscription/check-status/SUB202607022056385942` 和 `/api/_app/subscription/detail-by-no/SUB202607022056385942` 均返回"订阅不存在"
|
||
- **根因**：`getOrderQRCodeUnlimited` 接口（WxLoginController.java 第 441 行）**只生成小程序码，并不创建订阅记录**。如果生成小程序码时没有先调用 `subscribe` 接口，`subscriptionNo` 就只是个随机字符串，没有对应的数据库记录
|
||
- **修复（方案 1）**：新增 `POST /api/app/subscription/generate-pay-qrcode` 接口，在一个请求中完成：
|
||
1. 创建订阅记录（复用 `subscribe` 的核心逻辑，写入数据库）
|
||
2. 用 `subscriptionNo` 调用 `WxMiniprogramUtil.generateMiniprogramQrCode` 生成小程序码
|
||
3. 返回 `subscriptionNo` + Base64 图片
|
||
- **关联修改**：
|
||
- `AppPayProperties.java`：新增 `miniAppSecret` 字段（用于生成小程序码获取 access_token）
|
||
- `application-dev.yml` / `application-prod.yml`：添加 `mini-app-secret` 配置项（当前为占位符，需用户填写真实秘钥）
|
||
- `AppSubscriptionController.java` `mp-prepay`：已改为允许跨用户支付（`userId != null && !userId.equals(sub.getUserId())`）
|
||
- `AppSubscriptionController.java` `mp-confirm`：已改为未登录时跳过 userId 校验
|
||
- **下一步**：
|
||
1. 到微信公众平台获取小程序 `AppSecret`，填写到 `application-dev.yml` 和 `application-prod.yml` 的 `mini-app-secret` 字段
|
||
2. 重新构建部署后端
|
||
3. 调用新接口生成支付小程序码：`POST /api/app/subscription/generate-pay-qrcode` Body: `{"productId": 1, "subscriptionPeriod": "month", "envVersion": "trial"}`
|
||
4. 用返回的 `subscriptionNo` 测试 `check-status` 和 `detail-by-no` 接口，确认订阅记录已存在
|
||
|
||
### 补充修复
|
||
|
||
- `AppSubscriptionController.java` 的 `generate-pay-qrcode` 接口中，`switch (subscriptionPeriod)` 的 `case "month":` 空 fall through 触发 IDE 红色警告。已添加 `// fall through to default` 注释消除警告。
|