diff --git a/app/service/systemMethods/order/deliveryOrder.js b/app/service/systemMethods/order/deliveryOrder.js index d2272ea..5bc2f39 100644 --- a/app/service/systemMethods/order/deliveryOrder.js +++ b/app/service/systemMethods/order/deliveryOrder.js @@ -7,12 +7,39 @@ const { stripWaybillSegmentSuffix, escapeLikeWildcards } = require('../../../lib const DEBUG_LOG = path.join(__dirname, '..', '..', '..', '..', 'temp', 'quickSearch_debug.log'); -function dbg(msg) { - const ts = new Date().toISOString(); - const line = `[${ts}] ${msg}\n`; - try { fs.appendFileSync(DEBUG_LOG, line, 'utf8'); } catch (_) { /* ignore */ } +// 持久可写流:dbg 使用异步缓冲写,避免 appendFileSync 每次 open/write/close 的同步磁盘 IO +let debugStream = null; + +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 { constructor(ctx) { super(ctx); @@ -63,8 +90,10 @@ class DeliveryOrderService extends OrderBaseService { /** * 订单快速搜索。 - * 跨表联合搜索:运单号(wms_order_express,精确匹配,含剥离一单多件分段后缀后的主体等值匹配)、 - * 发货单号/外部订单号/平台交易单号(dispatch 表,模糊)。 + * 逐级短路搜索(wms_order_express 表),命中即停: + * 1. 运单号 waybill_code(等值 + 剥离一单多件分段后缀后的主体等值 + 主体前缀 LIKE); + * 2. 发货单号 delivery_order_code(等值优先,未命中再 %kw% 模糊); + * 3. 平台订单号 source_order_codes(%kw% 模糊兜底)。 * 返回匹配的订单列表(最多 20 条),包含订单关键信息及关联运单号。 * * @param {Object} data 请求体。 @@ -96,10 +125,14 @@ class DeliveryOrderService extends OrderBaseService { // 收集匹配的订单 ID(去重) const matchedOrderIds = new Set(); - // ====== 第一步:express 表 OR 搜索 ====== - dbg('--- Step1: express OR query ---'); + // ====== 第一步:express 表逐级短路搜索 ====== + // 命中顺序:运单号(waybill_code) → 发货单号(delivery_order_code) → 平台订单号(source_order_codes)。 + // 每一级只要命中即停止后续查询,直接进入订单详情查询。 + // 性能背景:单仓库 wms_order_express 行数达 60w+,逐级短路保证绝大多数场景 + // (运单号/完整发货单号)只走索引点查,模糊全扫仅作为最后兜底。 + dbg('--- Step1: express level search ---'); // 业务规则:运单号先剥离一单多件包裹序号后缀(如 -1-1-),主体必须等值匹配, - // 不得落入模糊 like;发货单号/平台交易单号保留模糊匹配能力 + // 不得落入模糊 like const waybillBase = stripWaybillSegmentSuffix(keyword); const escapedWaybillBase = escapeLikeWildcards(waybillBase); const waybillConditions = [ @@ -107,36 +140,86 @@ class DeliveryOrderService extends OrderBaseService { ...(waybillBase !== keyword ? [{ waybill_code: waybillBase }] : []), ...(escapedWaybillBase ? [{ waybill_code: { [Op.like]: `${escapedWaybillBase}-%` } }] : []), ]; - const expressWhere = { - warehouse_id: warehouseId, - [Op.or]: [ - ...waybillConditions, - { delivery_order_code: { [Op.like]: `%${keyword}%` } }, - { source_order_codes: { [Op.like]: `%${keyword}%` } }, - ], - }; - dbg(`expressWhere: ${JSON.stringify(expressWhere)}`); + dbg(`waybillBase="${waybillBase}" escapedWaybillBase="${escapedWaybillBase}"`); - let expressRecords; + let expressRecords = []; + let hitLevel = null; + + // Level 1:运单号(等值/主体等值/主体前缀,走 waybill_code 索引) try { expressRecords = await ctx.model.OrderExpress.findAll({ - 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', - ], - where: expressWhere, + attributes: EXPRESS_ATTRIBUTES, + where: { + warehouse_id: warehouseId, + [Op.or]: waybillConditions, + }, raw: true, limit: MAX_RESULTS, }); - dbg(`expressRecords count: ${expressRecords.length}`); + if (expressRecords.length > 0) hitLevel = 'waybill_code'; + dbg(`L1 waybill_code records: ${expressRecords.length}`); } catch (e) { - dbg(`expressRecords ERROR: ${e.message}`); - expressRecords = []; + dbg(`L1 ERROR: ${e.message}`); } + // 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(); 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}`);