fix(miniapp): 幂等键改为按操作稳定;删除指向 404 的互选死代码
1) 幂等键(配合后端机制)
原写法把 Date.now() 拼进幂等键,每次调用都生成新键,即使后端实现了幂等
也永远不会命中 —— 声明端与实现端各自都坏。
api.idempotencyKey(scope, subject):键缓存在 _pendingIdempotency(TTL 10min),
同一逻辑操作在成功之前复用同一把键,收到 200+success 才释放;失败(含网络错误)
不释放,下次重试沿用同一把键。25 处调用点(8 个 service + 2 个 TS 页面)全部替换,
Date.now 幂等键写法残留经 grep 为 0。
2) 删除死代码 submitInterests
它请求 POST /activities/{id}/interests —— 后端从未实现该端点
(Phase 16 已把表达意向合并进 /activities/{id}/feedback 的
interestTargetUserIds)。全仓确认无任何页面/组件调用方。
两个文件各留注释说明删除原因与恢复条件:若产品确认需要独立的
「提交互选」端点,应先定义语义并补后端实现,再恢复前端方法。
store 头部关于 AGENTS 第 6 条(单向意向保密)的注释同步改为引用
submitFeedback 返回的 newMutuals。
This commit is contained in:
@@ -7,6 +7,14 @@
|
||||
const { BUSINESS_LIMITS, REQUEST_ERROR } = require('../constants');
|
||||
const { API_BASE_URL } = require('../env');
|
||||
|
||||
/**
|
||||
* 未成功操作的幂等键保留时长。
|
||||
*
|
||||
* 取 10 分钟:足够覆盖用户「看到失败 → 重试」的常规间隔,又不至于让一把
|
||||
* 早该作废的键长期占据缓存、把两次真正独立的操作误认成同一次。
|
||||
*/
|
||||
const IDEMPOTENCY_KEY_TTL_MS = 10 * 60 * 1000;
|
||||
|
||||
class ApiClient {
|
||||
constructor() {
|
||||
this.baseURL = API_BASE_URL;
|
||||
@@ -16,6 +24,52 @@ class ApiClient {
|
||||
this.onSessionExpired = null;
|
||||
/** @type {((config: object) => void)|null} 维护态拦截回调,由 AppStore 注入 */
|
||||
this.onMaintenance = null;
|
||||
/** 未确认成功的幂等键缓存:操作指纹 -> {key, createdAt}。语义见 idempotencyKey()。 */
|
||||
this._pendingIdempotency = {};
|
||||
}
|
||||
|
||||
/**
|
||||
* 取一次逻辑操作的幂等键。
|
||||
*
|
||||
* @param {string} scope 操作域,如 'activity-register'
|
||||
* @param {string} [subject] 操作对象(活动 ID / 目标用户 ID 等)
|
||||
* @returns {string} 幂等键
|
||||
*
|
||||
* 幂等键的语义是「同一次逻辑操作的重复投递用同一把键」,而不是「每次调用
|
||||
* 一把新键」。此前各 service 自行拼 `xxx:${Date.now()}`,每次调用都是新键
|
||||
* —— 后端即便实现了幂等也永远命中不了,「弱网重发」照样产生重复数据。
|
||||
*
|
||||
* 这里由 api 层统一托管:同一次**尚未成功**的操作复用同一把键,
|
||||
* 成功后才释放,下一次点击才是新的一次操作。
|
||||
*/
|
||||
idempotencyKey(scope, subject) {
|
||||
const fingerprint = `${scope}::${subject == null ? '' : subject}`;
|
||||
const now = Date.now();
|
||||
const cached = this._pendingIdempotency[fingerprint];
|
||||
if (cached && now - cached.createdAt < IDEMPOTENCY_KEY_TTL_MS) {
|
||||
return cached.key;
|
||||
}
|
||||
const key = `${scope}:${subject == null ? '' : subject}:${this.generateRequestId()}`;
|
||||
this._pendingIdempotency[fingerprint] = { key, createdAt: now };
|
||||
return key;
|
||||
}
|
||||
|
||||
/**
|
||||
* 释放幂等键:一次逻辑操作成功后调用,下一次同域操作属新的一次。
|
||||
*
|
||||
* 公开方法:`request()` 内部在业务成功后自动调用;直接使用
|
||||
* `utils/requestPromise` 绕开本层封装的页面(如 counseling-request)
|
||||
* 需在成功后自行调用,否则一把旧键会被一直复用。
|
||||
*/
|
||||
releaseIdempotencyKey(key) {
|
||||
if (!key) return;
|
||||
const fingerprints = Object.keys(this._pendingIdempotency);
|
||||
for (let i = 0; i < fingerprints.length; i += 1) {
|
||||
if (this._pendingIdempotency[fingerprints[i]].key === key) {
|
||||
delete this._pendingIdempotency[fingerprints[i]];
|
||||
return;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/** 读取本地存储的 access token */
|
||||
@@ -98,6 +152,10 @@ class ApiClient {
|
||||
if (res.statusCode === 200) {
|
||||
const body = res.data || {};
|
||||
if (body.success) {
|
||||
// 操作已成功落地:释放幂等键,下一次同域操作是新的一次。
|
||||
// 失败时刻意**不释放** —— 用户重试时复用同一把键,
|
||||
// 后端才能识别出这是重复投递而不是第二次操作。
|
||||
this._releaseIdempotencyKey(idempotencyKey);
|
||||
resolve(body.data);
|
||||
} else {
|
||||
reject({
|
||||
|
||||
Reference in New Issue
Block a user