From 72cecc8d63bfc38e6e74969ff5e6969dc18a95e4 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Fri, 25 Sep 2026 01:50:21 +0800 Subject: [PATCH] =?UTF-8?q?feat(scan-diag):=20=E8=A1=A5=E9=BD=90=E4=B8=80?= =?UTF-8?q?=E6=AC=A1=E6=80=A7=E5=8F=91=E7=89=88=E6=89=80=E9=9C=80=E7=9A=84?= =?UTF-8?q?=E6=97=A5=E5=BF=97=E9=9D=A2=20-=20Window=E7=84=A6=E7=82=B9/?= =?UTF-8?q?=E8=BE=93=E5=85=A5=E6=B3=95=E7=8A=B6=E6=80=81=E5=85=A5=E5=BF=83?= =?UTF-8?q?=E8=B7=B3=E3=80=81=E9=9D=9E=E6=AD=A3=E5=B8=B8=E9=80=80=E5=87=BA?= =?UTF-8?q?=E6=A3=80=E6=B5=8B=E3=80=8110=E5=88=86=E9=92=9F=E5=81=A5?= =?UTF-8?q?=E5=BA=B7=E5=BF=AB=E7=85=A7=E3=80=81=E6=97=A0=E7=BB=93=E6=9D=9F?= =?UTF-8?q?=E7=AC=A6=E6=89=AB=E7=A0=81=E5=BC=82=E5=B8=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/core/device-probe.js | 60 ++++++++++++++++++++++++++++++++ src/core/error-report.js | 18 ++++++++++ src/core/scan-diag.js | 65 +++++++++++++++++++++++++++++++++++ src/core/scan.js | 49 +++++++++++++++++++++----- src/pages/packaging/index.vue | 62 +++++++++++++++++++++++++++------ 5 files changed, 236 insertions(+), 18 deletions(-) create mode 100644 src/core/device-probe.js diff --git a/src/core/device-probe.js b/src/core/device-probe.js new file mode 100644 index 0000000..15076b4 --- /dev/null +++ b/src/core/device-probe.js @@ -0,0 +1,60 @@ +/** + * App 端原生环境探测(仅 APP-PLUS 有效,其它平台返回空对象) + * + * 用途:把"按键能不能到 WebView"的两个决定性条件纳入心跳快照—— + * 1. winFocus:Activity/Window 是否仍有焦点。失去焦点时 Android 不会把按键派发到 WebView, + * 表现出来就是"扫码完全没反应"(真机上曾出现过无聚焦元素导致设备不投递按键的情况)。 + * 2. imeUp:输入法是否处于激活态。IME 位于 WebView 之前(dispatchKeyEventPreIme), + * 激活时按键会被输入法截获 —— 现场表现为"扫一次后不再接收"。 + * + * 注意:Native.js 桥接对象在 service 层不支持点方法调用,实例方法必须用 plus.android.invoke; + * 探测失败一律静默返回,绝不影响业务。 + */ + +// 结果缓存:看门狗每 2s 调一次,桥接调用不宜过于频繁 +const CACHE_MS = 10000 +let cached = null +let cachedAt = 0 + +export function probeAppWindow() { + const now = Date.now() + if (cached && now - cachedAt < CACHE_MS) { + return cached + } + const result = {} + try { + if ( + typeof plus === 'undefined' || + !plus || + !plus.android || + typeof plus.android.runtimeMainActivity !== 'function' + ) { + cached = result + cachedAt = now + return result + } + const main = plus.android.runtimeMainActivity() + if (!main) { + cached = result + cachedAt = now + return result + } + result.winFocus = !!plus.android.invoke(main, 'hasWindowFocus') + // Context.INPUT_METHOD_SERVICE = "input_method"(字符串直传,避免静态字段访问失败) + const imm = plus.android.invoke(main, 'getSystemService', 'input_method') + if (imm) { + result.imeUp = !!plus.android.invoke(imm, 'isActive') + } + } catch (e) { + // 探测失败静默 + } + cached = result + cachedAt = now + return result +} + +/** 清空缓存(页面切换/退后台后需要重新探测时调用) */ +export function resetAppWindowProbe() { + cached = null + cachedAt = 0 +} diff --git a/src/core/error-report.js b/src/core/error-report.js index 89c1580..40a0c44 100644 --- a/src/core/error-report.js +++ b/src/core/error-report.js @@ -327,6 +327,24 @@ function hookDiagSink() { diag: diagDigest(DIAG_EXTRA_MAX_EVENTS), }, }) + return + } + if (kind === 'anomaly') { + const name = String(payload.name || 'anomaly') + reportClientError({ + type: `scan-${name}`, + message: `扫码异常:${name}`, + extra: { anomaly: payload.data || {}, diag: diagDigest(DIAG_EXTRA_MAX_EVENTS) }, + }) + return + } + if (kind === 'health') { + // 周期健康快照:服务端拿到连续轨迹,能看出"哪一刻开始收不到按键" + reportClientError({ + type: 'scan-health', + message: '扫码健康快照', + extra: { health: payload }, + }) } } catch (e) { // 忽略:上报失败不影响扫码 diff --git a/src/core/scan-diag.js b/src/core/scan-diag.js index cbda9ee..f3b97e1 100644 --- a/src/core/scan-diag.js +++ b/src/core/scan-diag.js @@ -34,6 +34,8 @@ const KEY_RESUME_GAP_MS = 60 * 1000 const KEY_BURST_GAP_MS = 500 // 心跳定时器迟到判定:实际间隔 > 设定周期 * 该倍数 → 主线程被卡住 const STALL_FACTOR = 2.5 +// 服务端健康快照间隔:服务端拿到连续轨迹,而不只是异常点 +const REPORT_HEALTH_INTERVAL_MS = 10 * 60 * 1000 const state = { scope: 'unknown', @@ -53,6 +55,8 @@ const state = { lastTickAt: 0, maxTickGapMs: 0, stallCount: 0, + lastHealthReportAt: 0, + healthReportKeys: 0, loaded: false, persistedAt: 0, persistTimer: null, @@ -290,7 +294,34 @@ export function diagBegin(scope) { } state.scope = next const prev = state.prevCounters + const abnormal = detectPrevAbnormalExit() push('note', `session-start scope=${next}${prev ? ` 上次运行=${JSON.stringify(prev)}` : ''}`) + // 上次是"确实在用"的会话,且最后一条生命周期不是 onHide/onUnload → 疑似被系统杀掉/崩溃。 + // 长跑场景里"用着用着没反应"可能就是应用被回收后重进,这条能直接区分。 + if (abnormal && prev && (Number(prev.keys) >= 50 || Number(prev.flushes) >= 1)) { + diagAnomaly('abnormal-exit', abnormal) + } +} + +/** + * 上一次运行是否非正常结束(被杀/崩溃): + * 判据是"日志在非收尾状态下停止,且已经静默超过 1 分钟"。 + * 不能只看最后一条生命周期:页面切换时旧页 onHide 可能晚于新页 onShow, + * 但那种情况会在毫秒级继续写日志,gapMs 很小,不会命中。 + */ +function detectPrevAbnormalExit() { + const newest = state.events[state.events.length - 1] + if (!newest) { + return null + } + if (newest.kind === 'note' && /onHide|onUnload|deactivated/.test(newest.msg)) { + return null + } + const gapMs = Date.now() - newest.t + if (gapMs < 60000) { + return null + } + return { lastEvent: newest.msg, lastKind: newest.kind, gapMs } } /** 更新门控快照(会随健康心跳一起落盘,是定位"为何没反应"的核心依据) */ @@ -364,6 +395,21 @@ export function diagNote(name, data) { push('note', String(name || ''), data) } +/** + * 记录一次"值得服务端知道"的异常(除卡顿/自愈/丢弃之外的自定义异常)。 + * 例:abnormal-exit(上次非正常退出)、partial-code-no-terminator(扫码未收到结束符)。 + * 有外送上钩子时自动上报(error_type = scan-)。 + */ +export function diagAnomaly(name, data, options) { + load() + const key = String(name || 'anomaly') + push('anomaly', key, data) + // report:false 时只写本地日志不外送(用于需要本地限流的场景) + if (!options || options.report !== false) { + emitSink('anomaly', { name: key, data }) + } +} + /** * 设置/更新当前业务上下文(当前任务、期望条码等)。 * 变更时留一条记录:现场看日志时能直接对照“该收到哪个码 / 现在在做什么任务”。 @@ -422,6 +468,25 @@ export function diagHeartbeat(options) { `最近按键=${idleAgo} tick=${tickGap || intervalMs}ms 最大tick=${state.maxTickGapMs}ms 卡顿=${state.stallCount}`, state.gates ) + // 服务端健康快照:本会话确实收到过按键后,每 10 分钟外送一次, + // 这样"某一刻开始收不到按键"即使无人上报也能在服务端看出来(轨迹而不是只有异常点) + if (state.counters.keys > 0 && now - state.lastHealthReportAt >= REPORT_HEALTH_INTERVAL_MS) { + const keysSinceReport = state.counters.keys - state.healthReportKeys + state.lastHealthReportAt = now + state.healthReportKeys = state.counters.keys + emitSink('health', { + keysSinceReport, + keysTotal: state.counters.keys, + flushes: state.counters.flushes, + drops: state.counters.drops, + heals: state.counters.heals, + lastKeyAgoMs: state.lastKeyAt ? now - state.lastKeyAt : null, + stallCount: state.stallCount, + maxTickGapMs: state.maxTickGapMs, + gates: state.gates, + context: state.context, + }) + } } /** 立即落盘(页面 onHide/onUnload 时调用,避免节流窗口内丢日志) */ diff --git a/src/core/scan.js b/src/core/scan.js index aa6ae1b..131be9e 100644 --- a/src/core/scan.js +++ b/src/core/scan.js @@ -20,8 +20,10 @@ import { diagHeartbeat, diagSetGates, diagNote, + diagAnomaly, diagPersistNow, } from './scan-diag' +import { probeAppWindow } from './device-probe' // 空闲超过该时长后重新锁定 plus.key 实际生效的事件类型。 // 根因:本机实测只投递 keyup,若某次运行时锁被设成 'keydown'(其它来源的合成/注入事件), @@ -31,6 +33,8 @@ const IDLE_LOCK_RESET_MS = 1200 const LISTENER_REARM_IDLE_MS = 10 * 60 * 1000 // 自愈心跳间隔 const SELF_HEAL_INTERVAL_MS = 5000 +// "无结束符"异常上报的最小间隔(本地日志仍逐次记录) +const NO_TERMINATOR_ANOMALY_MIN_INTERVAL_MS = 10 * 60 * 1000 // Android KeyEvent 符号键映射(KEYCODE_* → 字符)。 // 这些 keyCode 与 ASCII 字母/数字区间重叠,必须优先于 ASCII 分支判断, @@ -71,6 +75,7 @@ let lastAnyKeyAt = 0 // 最近一次按键到达(含被门控丢弃的),用于 let rearmedForIdle = false // 本次空闲是否已重挂过监听(收到按键后复位) let selfHealTimer = null let selfHealStartedAt = 0 +let lastNoTerminatorAnomalyAt = 0 let plusKeyStyle = null // 'android' | 'ascii' let plusShiftDown = false let plusShiftPrev = false @@ -147,6 +152,28 @@ function flush(trigger, source) { // 记录完整条码与按键数:事后要能回答"这条到底扫到了什么"、"按键是否中途停了" diagFlush({ scope: receiverScope(), trigger, source, code, length: code.length, durationMs, keys: keyCount, lastKey }) debug('flush-buffer', { code, length: code.length, durationMs, trigger, source }) + // 扫码枪通常以 Enter 结尾:没有结束符就靠空闲 flush,优先怀疑按键流在结束符前中断 + if (trigger !== 'enter' && keyCount >= 4 && durationMs > 0 && durationMs <= 1500) { + const now = Date.now() + const shouldReport = now - lastNoTerminatorAnomalyAt >= NO_TERMINATOR_ANOMALY_MIN_INTERVAL_MS + if (shouldReport) { + lastNoTerminatorAnomalyAt = now + } + diagAnomaly( + 'partial-code-no-terminator', + { + scope: receiverScope(), + source, + code, + keys: keyCount, + length: code.length, + durationMs, + lastKey, + reported: shouldReport ? 1 : 0, + }, + { report: shouldReport } + ) + } if (receiver && typeof receiver.onScanCode === 'function') { try { @@ -546,14 +573,20 @@ export function startScanSelfHeal(intervalMs) { // 从未收到过按键时以心跳启动时刻为基准,否则"一直收不到"的情况永远不会触发重挂 const now = Date.now() const idleForRearmMs = now - (lastAnyKeyAt || selfHealStartedAt) - diagSetGates({ - scope: receiverScope(), - paused, - receiver: !!receiver, - plusAttached, - eventTypeLock: plusKeyEventType || 'none', - idleSec: lastAnyKeyAt ? Math.round((now - lastAnyKeyAt) / 1000) : 'never', - }) + diagSetGates( + Object.assign( + { + scope: receiverScope(), + paused, + receiver: !!receiver, + plusAttached, + eventTypeLock: plusKeyEventType || 'none', + idleSec: lastAnyKeyAt ? Math.round((now - lastAnyKeyAt) / 1000) : 'never', + }, + // 真机:Window 焦点 / 输入法状态(决定按键能否到达 WebView),H5 返回空对象 + probeAppWindow() + ) + ) if (receiver && idleForRearmMs > LISTENER_REARM_IDLE_MS && !rearmedForIdle) { rearmedForIdle = true removePlusListener() diff --git a/src/pages/packaging/index.vue b/src/pages/packaging/index.vue index 1ef626d..6009662 100644 --- a/src/pages/packaging/index.vue +++ b/src/pages/packaging/index.vue @@ -333,6 +333,7 @@ import { } from '@/api/index' import ScanDiagPanel from '@/components/scan-diag-panel.vue' import { + diagAnomaly, diagBegin, diagDrop, diagFlush, @@ -344,6 +345,7 @@ import { diagSetContext, diagSetGates, } from '@/core/scan-diag' +import { probeAppWindow } from '@/core/device-probe' // 扫码枪识别参数(广播扫描:扫码枪为键盘 HID 设备,按键事件全局广播) // 无回车结束符时:停止输入超过该毫秒数视为一次完整扫码,自动提交 @@ -353,6 +355,8 @@ const SCAN_MIN_LENGTH = 2 // 真机 plus 链路的最小码长:运单/商品码都是 8~13 位、工牌 64 位, // 1~3 字符必然是误触/输入法/枪配置异常,不得当运单提交 const SCAN_CODE_MIN_LENGTH = 4 +// "无结束符"异常上报的最小间隔(避免未配置后缀的枪刷爆服务端;本地日志仍逐次记录) +const NO_TERMINATOR_ANOMALY_MIN_INTERVAL_MS = 10 * 60 * 1000 // 手动输入识别:相邻按键间隔超过该毫秒数视为手动输入,不自动提交 const SCAN_BURST_MAX_GAP = 100 // Android KeyEvent 符号键映射(KEYCODE_* → 字符)。 @@ -425,6 +429,9 @@ export default { plusKeyLastAt: 0, // 本次扫码已处理的按键数(诊断用:区分"只收到 1 个字符"与"整个码都收到了") plusKeyBurstCount: 0, + // 最近一个原始 keyCode(诊断用)+ 无结束符异常上次上报时间 + plusKeyLastCode: 0, + lastNoTerminatorAnomalyAt: 0, // 字母大小写策略:'auto' 跟踪 Shift 键 / 'upper' 全大写 / 'lower' 全小写 // 注意:plus.key 只给 keyCode、无 Shift 状态;仅当扫码枪会额外上报 // Android Shift 键(KEYCODE_SHIFT_LEFT=59 / SHIFT_RIGHT=60)时 'auto' 才能还原大小写。 @@ -2043,16 +2050,22 @@ export default { this.attachGlobalKeyboardListener() this.ensureScanInputFocus() this.maybeRearmScanListenersWhenIdle() - diagSetGates({ - scope: 'packaging', - pageActive: this.pageActive !== false, - plusListener: !!(this.plusKeyListener || this.plusKeyUpListener), - domListener: !!this.globalKeyListener, - eventTypeLock: this._plusKeyEventType || 'none', - idleSec: this.lastScanKeyArrivedAt - ? Math.round((Date.now() - this.lastScanKeyArrivedAt) / 1000) - : 'never', - }) + diagSetGates( + Object.assign( + { + scope: 'packaging', + pageActive: this.pageActive !== false, + plusListener: !!(this.plusKeyListener || this.plusKeyUpListener), + domListener: !!this.globalKeyListener, + eventTypeLock: this._plusKeyEventType || 'none', + idleSec: this.lastScanKeyArrivedAt + ? Math.round((Date.now() - this.lastScanKeyArrivedAt) / 1000) + : 'never', + }, + // 真机:Window 焦点 / 输入法状态(决定按键能否到达 WebView),H5 返回空对象 + probeAppWindow() + ) + ) diagHeartbeat({ intervalMs: 2000 }) }, 2000) }, @@ -2309,6 +2322,7 @@ export default { handlePlusKeyEvent(event, type) { // 先记录「按键到达 JS」这一事实(任何门控之前),用于区分「按键根本没到」与「到了被门控丢掉」 const keyCode = Number((event && event.keyCode) || 0) + this.plusKeyLastCode = keyCode const gap = this.markScanKeyArrived('plus', { keyCode, type }) // 空闲后重新锁定实际生效的事件类型:自愈「锁错就永久静默」 if (this._plusKeyEventType && gap > SCAN_IDLE_LOCK_RESET_MS) { @@ -2423,8 +2437,36 @@ export default { } diagFlush({ trigger, source: 'plus', code, length: code.length, durationMs, keys: keyCount }) console.log('[packaging][scan] plus-buffer trigger =', trigger, 'code =', code, 'keys =', keyCount) + // 扫码枪通常以 Enter 结尾(真机日志 trigger=enter):没有结束符就靠空闲 flush, + // 优先怀疑按键流在结束符前中断(也可能枪未配置后缀,服务端按 10 分钟一条区分) + if (trigger !== 'enter' && keyCount >= 4 && durationMs > 0 && durationMs <= 1500) { + this.reportNoTerminatorScan(code, keyCount, durationMs) + } this.submitScanCode(code, 'plus') }, + /** + * 扫码没收到结束符就被 flush:记一条 anomaly(本地逐次记录,服务端限流上报)。 + * 服务端据此区分"枪无后缀"(常态化)与"按键中途停止投递"(异常)。 + */ + reportNoTerminatorScan(code, keys, durationMs) { + const now = Date.now() + const shouldReport = now - (this.lastNoTerminatorAnomalyAt || 0) >= NO_TERMINATOR_ANOMALY_MIN_INTERVAL_MS + if (shouldReport) { + this.lastNoTerminatorAnomalyAt = now + } + diagAnomaly( + 'partial-code-no-terminator', + { + code, + keys, + length: code.length, + durationMs, + lastKeyCode: this.plusKeyLastCode || 0, + reported: shouldReport ? 1 : 0, + }, + { report: shouldReport } + ) + }, handleHiddenScanFocus() { if (!this.isPageActive() || !this.enableHiddenInputCapture) { return