fix(inbox): notify.reply 按群/消息来源应用路由回执
同一仓库存在多个仓库级 API 应用且都勾选 notify.reply 时,回执按 id 升序逐个尝试, 可能被首个返回 200 的其它适配器接走,导致错投且被记为已送达。 - receiver: 群已存在时补写空白的 source_type/source_extra,来源不一致仅告警不覆盖 - processor: 回执来源优先级改为 群(wms_inbox_group) → 入站消息 → ext_id 解析, 来源应用承接时只发给它;来源缺失或未承接时保持原候选顺序并告警 - warehouseNotify: push 支持 preferredAppKey,系统通知按群来源应用发送 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
parent
083f2846e0
commit
3c0c7634c5
@ -527,8 +527,16 @@ class InboxProcessorService extends Service {
|
||||
}
|
||||
|
||||
const ackExtId = `sys:ack:${extId}`;
|
||||
// 多候选路由:按 method 查询全部承接应用(id 升序),逐个尝试直到成功
|
||||
const callbackConfigs = await this.listApiAppCallbackConfigs(warehouseId, 'notify.reply');
|
||||
// 多候选路由:按 method 查询全部承接应用(id 升序),逐个尝试直到成功。
|
||||
// 同一仓库可能存在多个仓库级 API 应用,必须先按「群/消息来源应用」收敛候选
|
||||
// (群以 wms_inbox_group 为准):否则回执可能被首个返回 200 的其它适配器接走,
|
||||
// 错投且被记为已送达。
|
||||
const sourceAppKey = await this.resolveReplySourceAppKey({ parentId, groupId, warehouseId, extId });
|
||||
const callbackConfigs = this.orderCallbackConfigsBySource(
|
||||
await this.listApiAppCallbackConfigs(warehouseId, 'notify.reply'),
|
||||
sourceAppKey,
|
||||
{ warehouseId, extId }
|
||||
);
|
||||
// 重推(reuse_message_id>0):直接复用原记录,避免按 sys:ack: 前缀另建一条记录——
|
||||
// 那样会让原记录(如 sys:notice:* 系统通知)状态永远停留在失败/待推送,且每次重推都新建记录
|
||||
// 声明在 try 之外:异常兜底回写失败状态时仍需定位到该记录
|
||||
@ -903,6 +911,98 @@ class InboxProcessorService extends Service {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 从来源记录中提取仓库级 API 应用的 AppKey。
|
||||
* 仅 source_type='api' 时 source_extra 才是 appKey(IM 来源存的是平台标识)。
|
||||
* @param {Object|null} row 入站消息或群记录。
|
||||
* @return {string|null} 来源应用 AppKey。
|
||||
*/
|
||||
pickApiSourceAppKey(row) {
|
||||
if (!row || String(row.source_type || '') !== 'api') return null;
|
||||
const appKey = String(row.source_extra || '').trim();
|
||||
return appKey || null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 解析回执应发往的来源应用 AppKey。
|
||||
* 优先级:群创建来源(wms_inbox_group 为准)→ 入站消息来源 → ext_id(api:{appKey}:{requestId})兜底。
|
||||
* 群是站内信的会话归属中心,内部通知与回执都从群配置出发,优先按群来源收敛候选。
|
||||
* @param {Object} options 解析参数。
|
||||
* @param {number} [options.parentId] 入站消息记录 ID。
|
||||
* @param {string} [options.groupId] 外部群 ID。
|
||||
* @param {number} [options.warehouseId] 仓库 ID。
|
||||
* @param {string} [options.extId] 入站消息 ext_id。
|
||||
* @return {Promise<string|null>} 来源应用 AppKey。
|
||||
*/
|
||||
async resolveReplySourceAppKey({ parentId, groupId, warehouseId, extId } = {}) {
|
||||
const { ctx } = this;
|
||||
|
||||
const groupIdStr = String(groupId || '').trim();
|
||||
if (groupIdStr && Number(warehouseId) > 0) {
|
||||
try {
|
||||
const group = await ctx.model.InboxGroup.findOne({
|
||||
attributes: [ 'source_type', 'source_extra' ],
|
||||
where: { group_id: groupIdStr, warehouse_id: Number(warehouseId) },
|
||||
raw: true,
|
||||
});
|
||||
const appKey = this.pickApiSourceAppKey(group);
|
||||
if (appKey) return appKey;
|
||||
} catch (error) {
|
||||
ctx.logger.warn(`[inbox processor] 查询群来源失败: ${error.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
const inboundId = Number(parentId) || 0;
|
||||
if (inboundId > 0) {
|
||||
try {
|
||||
const row = await ctx.model.InboxMessage.findOne({
|
||||
attributes: [ 'source_type', 'source_extra' ],
|
||||
where: { id: inboundId, warehouse_id: Number(warehouseId) || 0 },
|
||||
raw: true,
|
||||
});
|
||||
const appKey = this.pickApiSourceAppKey(row);
|
||||
if (appKey) return appKey;
|
||||
} catch (error) {
|
||||
ctx.logger.warn(`[inbox processor] 查询入站消息来源失败: ${error.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
// ext_id 约定:api:{appKey}:{requestId}
|
||||
const matched = /^api:([^:]+):/.exec(String(extId || ''));
|
||||
return matched ? matched[1] : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 按来源应用收敛回执候选:来源应用承接时只发给它,避免多应用错投;
|
||||
* 来源缺失或未承接时保持原有候选顺序(兼容旧行为)并记录告警。
|
||||
* @param {Array<Object>} candidates 候选应用列表(含 appKey)。
|
||||
* @param {string|null} sourceAppKey 来源应用 AppKey。
|
||||
* @param {Object} [context] 日志上下文。
|
||||
* @param {number} [context.warehouseId] 仓库 ID。
|
||||
* @param {string} [context.extId] 消息 ext_id。
|
||||
* @return {Array<Object>} 收敛后的候选列表。
|
||||
*/
|
||||
orderCallbackConfigsBySource(candidates, sourceAppKey, { warehouseId, extId } = {}) {
|
||||
const list = Array.isArray(candidates) ? candidates : [];
|
||||
if (list.length <= 1) return list;
|
||||
|
||||
const sourceKey = String(sourceAppKey || '').trim();
|
||||
if (!sourceKey) {
|
||||
this.ctx.logger.warn(
|
||||
`[inbox processor] 无法确定回执来源应用,按候选顺序尝试 warehouse=${warehouseId} ext_id=${extId} candidates=${list.length}`
|
||||
);
|
||||
return list;
|
||||
}
|
||||
|
||||
const matched = list.filter(item => String(item.appKey || '').trim() === sourceKey);
|
||||
if (matched.length > 0) return matched;
|
||||
|
||||
this.ctx.logger.warn(
|
||||
`[inbox processor] 来源应用未承接 notify.reply,按候选顺序兜底 warehouse=${warehouseId} source_app=${sourceKey} ext_id=${extId} candidates=${list.length}`
|
||||
);
|
||||
return list;
|
||||
}
|
||||
|
||||
/**
|
||||
* 单次回执推送尝试(回执专用协议:MD5(appSecret+timestamp+bodyJson) + POST)。
|
||||
* 每次尝试均写 wms_warehouse_log,失败不改动接口配置。
|
||||
|
||||
@ -156,14 +156,34 @@ class InboxReceiverService extends Service {
|
||||
});
|
||||
|
||||
if (group) {
|
||||
// 群已存在:名称变化时更新名称,不新建
|
||||
if (group.group_name !== groupName) {
|
||||
const oldName = group.group_name;
|
||||
await group.update({ group_name: groupName });
|
||||
// 群已存在:名称变化时更新名称,不新建。
|
||||
// 来源字段为空时补写(用于出站 notify.reply 按来源应用路由);
|
||||
// 已有来源且与本次不一致时不覆盖,避免多应用共用群时归属被反复改写。
|
||||
const patch = {};
|
||||
const oldName = group.group_name;
|
||||
if (oldName !== groupName) {
|
||||
patch.group_name = groupName;
|
||||
}
|
||||
if (!group.source_type && sourceType) {
|
||||
patch.source_type = sourceType;
|
||||
}
|
||||
if (!group.source_extra && data.source_extra) {
|
||||
patch.source_extra = data.source_extra;
|
||||
}
|
||||
if (Object.keys(patch).length > 0) {
|
||||
await group.update(patch);
|
||||
}
|
||||
if (patch.group_name) {
|
||||
ctx.logger.info(
|
||||
`[inbox] 群名称已更新 group_id=${extGroupId}: ${oldName} → ${groupName}`
|
||||
);
|
||||
}
|
||||
if (group.source_extra && data.source_extra
|
||||
&& String(group.source_extra) !== String(data.source_extra)) {
|
||||
ctx.logger.warn(
|
||||
`[inbox] 群来源不一致 group_id=${extGroupId} existing=${group.source_extra} incoming=${data.source_extra}`
|
||||
);
|
||||
}
|
||||
} else {
|
||||
// 群ID不存在:按群ID直接新建(群以ID为准,不按名称匹配既有群)
|
||||
await ctx.model.InboxGroup.create({
|
||||
|
||||
@ -120,6 +120,60 @@ class WarehouseNotifyService extends Service {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 按来源应用收敛候选:来源应用承接时只发给它,避免多应用错投;
|
||||
* 来源缺失或未承接时保持原有候选顺序(兼容旧行为)并记录告警。
|
||||
* @param {Array<Object>} candidates 候选应用列表(含 appKey)。
|
||||
* @param {string|null} preferredAppKey 期望的目标应用 AppKey。
|
||||
* @param {number} warehouseId 仓库 ID。
|
||||
* @return {Array<Object>} 收敛后的候选列表。
|
||||
*/
|
||||
orderCandidatesBySource(candidates, preferredAppKey, warehouseId) {
|
||||
const list = Array.isArray(candidates) ? candidates : [];
|
||||
if (list.length <= 1) return list;
|
||||
|
||||
const appKey = String(preferredAppKey || '').trim();
|
||||
if (!appKey) {
|
||||
this.ctx.logger.warn(
|
||||
`[warehouseNotify] 无法确定来源应用,按候选顺序尝试 warehouse=${warehouseId} candidates=${list.length}`
|
||||
);
|
||||
return list;
|
||||
}
|
||||
|
||||
const matched = list.filter(item => String(item.appKey || '').trim() === appKey);
|
||||
if (matched.length > 0) return matched;
|
||||
|
||||
this.ctx.logger.warn(
|
||||
`[warehouseNotify] 来源应用未承接回调,按候选顺序兜底 warehouse=${warehouseId} source_app=${appKey} candidates=${list.length}`
|
||||
);
|
||||
return list;
|
||||
}
|
||||
|
||||
/**
|
||||
* 读取群的创建来源应用 AppKey(仅 source_type='api' 时有效)。
|
||||
* @param {string} groupId 外部群 ID。
|
||||
* @param {number} warehouseId 仓库 ID。
|
||||
* @return {Promise<string|null>} 来源应用 AppKey。
|
||||
*/
|
||||
async resolveGroupSourceAppKey(groupId, warehouseId) {
|
||||
const { ctx } = this;
|
||||
const groupIdStr = String(groupId || '').trim();
|
||||
if (!groupIdStr || !Number(warehouseId)) return null;
|
||||
|
||||
try {
|
||||
const group = await ctx.model.InboxGroup.findOne({
|
||||
attributes: [ 'source_type', 'source_extra' ],
|
||||
where: { group_id: groupIdStr, warehouse_id: Number(warehouseId) },
|
||||
raw: true,
|
||||
});
|
||||
if (!group || String(group.source_type || '') !== 'api') return null;
|
||||
return String(group.source_extra || '').trim() || null;
|
||||
} catch (error) {
|
||||
ctx.logger.warn(`[warehouseNotify] 查询群来源失败: ${error.message}`);
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 计算 MD5 签名:MD5(appSecret + timestamp + bodyJson)。
|
||||
* @param {Object} options 签名参数。
|
||||
@ -268,17 +322,23 @@ class WarehouseNotifyService extends Service {
|
||||
* 向仓库 ApiApp 回调地址推送消息(MD5 签名 + POST)。
|
||||
* 路由规则:查承接该 method 的全部候选应用(按 id 升序)逐个尝试,
|
||||
* 第一个成功即返回;全部失败返回失败且不改动任何接口配置。
|
||||
* 传入 preferredAppKey 时优先只发给该应用(来源亲和),避免多应用场景错投。
|
||||
* @param {Object} options 推送参数。
|
||||
* @param {number} options.warehouseId 仓库 ID。
|
||||
* @param {string} [options.method='notify.reply'] 出站 method。
|
||||
* @param {Object} [options.data={}] 消息数据(包裹在 body.data 中)。
|
||||
* @param {string} [options.preferredAppKey=null] 期望的目标应用 AppKey。
|
||||
* @return {Promise<Object>} 推送结果(含 attempts 明细)。
|
||||
*/
|
||||
async push({ warehouseId, method = 'notify.reply', data = {} } = {}) {
|
||||
async push({ warehouseId, method = 'notify.reply', data = {}, preferredAppKey = null } = {}) {
|
||||
const { ctx } = this;
|
||||
const methodStr = String(method || '').trim() || 'notify.reply';
|
||||
|
||||
const candidates = await this.listCallbackConfigs(warehouseId, methodStr);
|
||||
const candidates = this.orderCandidatesBySource(
|
||||
await this.listCallbackConfigs(warehouseId, methodStr),
|
||||
preferredAppKey,
|
||||
warehouseId
|
||||
);
|
||||
if (candidates.length === 0) {
|
||||
ctx.logger.info(`[warehouseNotify] 仓库 ${warehouseId} 无应用承接回调 method=${methodStr},跳过推送`);
|
||||
return {
|
||||
@ -469,10 +529,13 @@ class WarehouseNotifyService extends Service {
|
||||
pushData.user_id = normalizedUserIds;
|
||||
}
|
||||
|
||||
// 群来源应用优先:同一仓库多应用承接 notify.reply 时避免系统通知错投渠道
|
||||
const preferredAppKey = await this.resolveGroupSourceAppKey(groupId, warehouseId);
|
||||
const result = await this.push({
|
||||
warehouseId,
|
||||
method: 'notify.reply',
|
||||
data: pushData,
|
||||
preferredAppKey,
|
||||
});
|
||||
|
||||
// 回写推送状态(失败仅记日志,不影响业务)
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user