perf(order): quickSearch 改为逐级短路搜索
命中顺序:运单号(waybill_code) -> 发货单号(delivery_order_code) -> 平台订单号(source_order_codes), 每一级只要命中即停止后续查询,直接进入订单详情。 - 运单号:等值 + 剥离一单多件分段后缀主体等值 + 主体前缀 LIKE,走 waybill_code 索引 - 发货单号:等值走 idx_delivery_code_store;未命中再 %kw% 模糊兜底 - 平台订单号:%kw% 模糊仅作最后兜底 避免原单条 OR 查询混合等值与 %kw% 模糊导致优化器放弃索引、 退化为按 warehouse_id 全仓库扫描(生产单仓库 66w+ 行)。 dbg 调试日志改为持久写流异步写入,消除 appendFileSync 同步磁盘 IO。
This commit is contained in:
parent
c6224b471e
commit
ce04778021
@ -7,12 +7,39 @@ const { stripWaybillSegmentSuffix, escapeLikeWildcards } = require('../../../lib
|
|||||||
|
|
||||||
const DEBUG_LOG = path.join(__dirname, '..', '..', '..', '..', 'temp', 'quickSearch_debug.log');
|
const DEBUG_LOG = path.join(__dirname, '..', '..', '..', '..', 'temp', 'quickSearch_debug.log');
|
||||||
|
|
||||||
function dbg(msg) {
|
// 持久可写流:dbg 使用异步缓冲写,避免 appendFileSync 每次 open/write/close 的同步磁盘 IO
|
||||||
const ts = new Date().toISOString();
|
let debugStream = null;
|
||||||
const line = `[${ts}] ${msg}\n`;
|
|
||||||
try { fs.appendFileSync(DEBUG_LOG, line, 'utf8'); } catch (_) { /* ignore */ }
|
function getDebugStream() {
|
||||||
|
if (!debugStream) {
|
||||||
|
try {
|
||||||
|
debugStream = fs.createWriteStream(DEBUG_LOG, { flags: 'a' });
|
||||||
|
debugStream.on('error', () => {
|
||||||
|
debugStream = null;
|
||||||
|
});
|
||||||
|
} catch (_) {
|
||||||
|
debugStream = null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return debugStream;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
function dbg(msg) {
|
||||||
|
const stream = getDebugStream();
|
||||||
|
if (!stream) return;
|
||||||
|
const line = `[${new Date().toISOString()}] ${msg}\n`;
|
||||||
|
try { stream.write(line); } catch (_) { /* ignore */ }
|
||||||
|
}
|
||||||
|
|
||||||
|
// express 表查询列(1a/1b/1c 三段共用)
|
||||||
|
const EXPRESS_ATTRIBUTES = [
|
||||||
|
'id', 'order_id', 'waybill_code', 'delivery_order_code', 'source_order_codes', 'store_id',
|
||||||
|
'logistics_code', 'logistics_name',
|
||||||
|
'logistics_interface_id', 'logistics_interface_name',
|
||||||
|
'platform_code', 'status', 'is_back', 'is_intercept', 'is_galaxy_receive',
|
||||||
|
'weighing_weight',
|
||||||
|
];
|
||||||
|
|
||||||
class DeliveryOrderService extends OrderBaseService {
|
class DeliveryOrderService extends OrderBaseService {
|
||||||
constructor(ctx) {
|
constructor(ctx) {
|
||||||
super(ctx);
|
super(ctx);
|
||||||
@ -63,8 +90,10 @@ class DeliveryOrderService extends OrderBaseService {
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* 订单快速搜索。
|
* 订单快速搜索。
|
||||||
* 跨表联合搜索:运单号(wms_order_express,精确匹配,含剥离一单多件分段后缀后的主体等值匹配)、
|
* 逐级短路搜索(wms_order_express 表),命中即停:
|
||||||
* 发货单号/外部订单号/平台交易单号(dispatch 表,模糊)。
|
* 1. 运单号 waybill_code(等值 + 剥离一单多件分段后缀后的主体等值 + 主体前缀 LIKE);
|
||||||
|
* 2. 发货单号 delivery_order_code(等值优先,未命中再 %kw% 模糊);
|
||||||
|
* 3. 平台订单号 source_order_codes(%kw% 模糊兜底)。
|
||||||
* 返回匹配的订单列表(最多 20 条),包含订单关键信息及关联运单号。
|
* 返回匹配的订单列表(最多 20 条),包含订单关键信息及关联运单号。
|
||||||
*
|
*
|
||||||
* @param {Object} data 请求体。
|
* @param {Object} data 请求体。
|
||||||
@ -96,10 +125,14 @@ class DeliveryOrderService extends OrderBaseService {
|
|||||||
// 收集匹配的订单 ID(去重)
|
// 收集匹配的订单 ID(去重)
|
||||||
const matchedOrderIds = new Set();
|
const matchedOrderIds = new Set();
|
||||||
|
|
||||||
// ====== 第一步:express 表 OR 搜索 ======
|
// ====== 第一步:express 表逐级短路搜索 ======
|
||||||
dbg('--- Step1: express OR query ---');
|
// 命中顺序:运单号(waybill_code) → 发货单号(delivery_order_code) → 平台订单号(source_order_codes)。
|
||||||
|
// 每一级只要命中即停止后续查询,直接进入订单详情查询。
|
||||||
|
// 性能背景:单仓库 wms_order_express 行数达 60w+,逐级短路保证绝大多数场景
|
||||||
|
// (运单号/完整发货单号)只走索引点查,模糊全扫仅作为最后兜底。
|
||||||
|
dbg('--- Step1: express level search ---');
|
||||||
// 业务规则:运单号先剥离一单多件包裹序号后缀(如 -1-1-),主体必须等值匹配,
|
// 业务规则:运单号先剥离一单多件包裹序号后缀(如 -1-1-),主体必须等值匹配,
|
||||||
// 不得落入模糊 like;发货单号/平台交易单号保留模糊匹配能力
|
// 不得落入模糊 like
|
||||||
const waybillBase = stripWaybillSegmentSuffix(keyword);
|
const waybillBase = stripWaybillSegmentSuffix(keyword);
|
||||||
const escapedWaybillBase = escapeLikeWildcards(waybillBase);
|
const escapedWaybillBase = escapeLikeWildcards(waybillBase);
|
||||||
const waybillConditions = [
|
const waybillConditions = [
|
||||||
@ -107,36 +140,86 @@ class DeliveryOrderService extends OrderBaseService {
|
|||||||
...(waybillBase !== keyword ? [{ waybill_code: waybillBase }] : []),
|
...(waybillBase !== keyword ? [{ waybill_code: waybillBase }] : []),
|
||||||
...(escapedWaybillBase ? [{ waybill_code: { [Op.like]: `${escapedWaybillBase}-%` } }] : []),
|
...(escapedWaybillBase ? [{ waybill_code: { [Op.like]: `${escapedWaybillBase}-%` } }] : []),
|
||||||
];
|
];
|
||||||
const expressWhere = {
|
dbg(`waybillBase="${waybillBase}" escapedWaybillBase="${escapedWaybillBase}"`);
|
||||||
warehouse_id: warehouseId,
|
|
||||||
[Op.or]: [
|
|
||||||
...waybillConditions,
|
|
||||||
{ delivery_order_code: { [Op.like]: `%${keyword}%` } },
|
|
||||||
{ source_order_codes: { [Op.like]: `%${keyword}%` } },
|
|
||||||
],
|
|
||||||
};
|
|
||||||
dbg(`expressWhere: ${JSON.stringify(expressWhere)}`);
|
|
||||||
|
|
||||||
let expressRecords;
|
let expressRecords = [];
|
||||||
|
let hitLevel = null;
|
||||||
|
|
||||||
|
// Level 1:运单号(等值/主体等值/主体前缀,走 waybill_code 索引)
|
||||||
try {
|
try {
|
||||||
expressRecords = await ctx.model.OrderExpress.findAll({
|
expressRecords = await ctx.model.OrderExpress.findAll({
|
||||||
attributes: [
|
attributes: EXPRESS_ATTRIBUTES,
|
||||||
'id', 'order_id', 'waybill_code', 'delivery_order_code', 'source_order_codes', 'store_id',
|
where: {
|
||||||
'logistics_code', 'logistics_name',
|
warehouse_id: warehouseId,
|
||||||
'logistics_interface_id', 'logistics_interface_name',
|
[Op.or]: waybillConditions,
|
||||||
'platform_code', 'status', 'is_back', 'is_intercept', 'is_galaxy_receive',
|
},
|
||||||
'weighing_weight',
|
|
||||||
],
|
|
||||||
where: expressWhere,
|
|
||||||
raw: true,
|
raw: true,
|
||||||
limit: MAX_RESULTS,
|
limit: MAX_RESULTS,
|
||||||
});
|
});
|
||||||
dbg(`expressRecords count: ${expressRecords.length}`);
|
if (expressRecords.length > 0) hitLevel = 'waybill_code';
|
||||||
|
dbg(`L1 waybill_code records: ${expressRecords.length}`);
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
dbg(`expressRecords ERROR: ${e.message}`);
|
dbg(`L1 ERROR: ${e.message}`);
|
||||||
expressRecords = [];
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Level 2a:发货单号等值(走 idx_delivery_code_store 索引)
|
||||||
|
if (!hitLevel) {
|
||||||
|
try {
|
||||||
|
expressRecords = await ctx.model.OrderExpress.findAll({
|
||||||
|
attributes: EXPRESS_ATTRIBUTES,
|
||||||
|
where: {
|
||||||
|
warehouse_id: warehouseId,
|
||||||
|
delivery_order_code: keyword,
|
||||||
|
},
|
||||||
|
raw: true,
|
||||||
|
limit: MAX_RESULTS,
|
||||||
|
});
|
||||||
|
if (expressRecords.length > 0) hitLevel = 'delivery_order_code';
|
||||||
|
dbg(`L2a delivery_order_code exact records: ${expressRecords.length}`);
|
||||||
|
} catch (e) {
|
||||||
|
dbg(`L2a ERROR: ${e.message}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Level 2b:发货单号模糊兜底(中缀 LIKE 无法走索引,仅在等值未命中时执行)
|
||||||
|
if (!hitLevel) {
|
||||||
|
try {
|
||||||
|
expressRecords = await ctx.model.OrderExpress.findAll({
|
||||||
|
attributes: EXPRESS_ATTRIBUTES,
|
||||||
|
where: {
|
||||||
|
warehouse_id: warehouseId,
|
||||||
|
delivery_order_code: { [Op.like]: `%${keyword}%` },
|
||||||
|
},
|
||||||
|
raw: true,
|
||||||
|
limit: MAX_RESULTS,
|
||||||
|
});
|
||||||
|
if (expressRecords.length > 0) hitLevel = 'delivery_order_code_like';
|
||||||
|
dbg(`L2b delivery_order_code like records: ${expressRecords.length}`);
|
||||||
|
} catch (e) {
|
||||||
|
dbg(`L2b ERROR: ${e.message}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Level 3:平台订单号(无索引全扫兜底,最后一级,仅前两级均未命中时执行)
|
||||||
|
if (!hitLevel) {
|
||||||
|
try {
|
||||||
|
expressRecords = await ctx.model.OrderExpress.findAll({
|
||||||
|
attributes: EXPRESS_ATTRIBUTES,
|
||||||
|
where: {
|
||||||
|
warehouse_id: warehouseId,
|
||||||
|
source_order_codes: { [Op.like]: `%${keyword}%` },
|
||||||
|
},
|
||||||
|
raw: true,
|
||||||
|
limit: MAX_RESULTS,
|
||||||
|
});
|
||||||
|
if (expressRecords.length > 0) hitLevel = 'source_order_codes';
|
||||||
|
dbg(`L3 source_order_codes records: ${expressRecords.length}`);
|
||||||
|
} catch (e) {
|
||||||
|
dbg(`L3 ERROR: ${e.message}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
dbg(`hitLevel=${hitLevel}`);
|
||||||
|
|
||||||
const waybillMap = new Map();
|
const waybillMap = new Map();
|
||||||
for (const er of expressRecords) {
|
for (const er of expressRecords) {
|
||||||
dbg(` er: id=${er.id} order_id=${er.order_id} waybill_code=${er.waybill_code} delivery_order_code=${er.delivery_order_code}`);
|
dbg(` er: id=${er.id} order_id=${er.order_id} waybill_code=${er.waybill_code} delivery_order_code=${er.delivery_order_code}`);
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user