'use strict'; const { Service } = require('egg'); const crypto = require('crypto'); /** * 云端「边缘任务」通道 * * 背景:查询机(A)和打包仓库(B)在不同公司/不同网络,B 没有公网 IP。 * 所以**永远由 B 主动出站**领任务,云端从不反向连它 —— 这条通道复用的就是 * 设备心跳那条出站链路(`POST /api/scanner/tasks/poll` 挂住等任务)。 * * 只做控制面: * 云端入队 → 设备长轮询领取 → 设备回结果 * * 队列用 Redis List(多实例共享,天然不依赖 sticky session), * 结果放短 TTL 的 key,过期即视为「设备没回」。 */ /** 超过这个时间没心跳就认为设备离线(与心跳间隔 60s 留足余量) */ const SCANNER_ONLINE_MS = 5 * 60 * 1000; /** 任务与结果的保留时间:任务没人领就丢,结果没人取就丢 */ const TASK_TTL_SECONDS = 180; const RESULT_TTL_SECONDS = 180; /** 单次校验最多等多久(设备侧真拉一小段,正常 2~5 秒) */ const DEFAULT_WAIT_MS = 8000; /** 同一主体最多试几台设备(多仓库时逐个试,连不上 NVR 的会被跳过) */ const MAX_DEVICES = 2; class EdgeTaskService extends Service { get redis() { return this.app.redis; } get prefix() { return (this.config.cache && this.config.cache.prefix) || ''; } queueKey(scannerId) { return `${this.prefix}edge:task:${Number(scannerId)}`; } resultKey(taskId) { return `${this.prefix}edge:result:${taskId}`; } /** * 同主体里最近有心跳的扫码服务(可代取的候选,按心跳时间倒序) * @param {number} subjectId * @return {Promise} scanners 原始行 */ async onlineScanners(subjectId) { const Scanners = this.app.model.Scanner; const threshold = new Date(Date.now() - SCANNER_ONLINE_MS); return Scanners.findAll({ where: { subjectId: Number(subjectId), status: 1, lastSeenAt: { [this.app.Sequelize.Op.gte]: threshold }, }, order: [ [ 'last_seen_at', 'DESC' ] ], limit: MAX_DEVICES, raw: true, }); } /** * 入队一个任务 * @param {number} scannerId 目标设备 * @param {string} type 任务类型(check / download) * @param {object} payload 任务参数 * @return {Promise} 含 id 的任务对象 */ async enqueue(scannerId, type, payload) { const task = { id: crypto.randomUUID(), type, payload, createdAt: new Date().toISOString(), }; const key = this.queueKey(scannerId); await this.redis.lpush(key, JSON.stringify(task)); // 队列本身也给个 TTL:设备长期离线时不让任务无限堆积 await this.redis.expire(key, TASK_TTL_SECONDS); return task; } /** * 设备侧领取任务(长轮询) * * ⚠️ 不用 BLPOP:egg-redis 是共享连接,阻塞命令会把其它请求一起卡住。 * 这里用短间隔轮询,代价是一次 task 最多 200ms 的额外延迟,可以接受。 * * @param {number} scannerId * @param {number} waitMs 最长挂多久 * @return {Promise} 没任务返回 null */ async poll(scannerId, waitMs) { const deadline = Date.now() + Math.max(0, Number(waitMs) || 0); const key = this.queueKey(scannerId); for (;;) { const raw = await this.redis.rpop(key); if (raw) { try { return JSON.parse(raw); } catch (err) { this.ctx.logger.warn('[edge] 任务解析失败,丢弃:%s', err.message); } } if (Date.now() >= deadline) return null; await sleep(200); } } /** * 设备回结果 * @param {string} taskId * @param {object} payload { ok, data | error } */ async submitResult(taskId, payload) { const id = String(taskId || '').trim(); if (!id) return false; await this.redis.setex(this.resultKey(id), RESULT_TTL_SECONDS, JSON.stringify(payload || {})); return true; } /** * 等结果(调用方是 web 请求,用户正等着) * @param {string} taskId * @param {number} timeoutMs * @return {Promise} 超时返回 null */ async waitResult(taskId, timeoutMs) { const key = this.resultKey(taskId); const deadline = Date.now() + Math.max(0, Number(timeoutMs) || DEFAULT_WAIT_MS); for (;;) { const raw = await this.redis.get(key); if (raw) { try { return JSON.parse(raw); } catch (err) { return null; } } if (Date.now() >= deadline) return null; await sleep(150); } } /** * 问「这段录像有没有帧」 * * 顺序:本主体在线的扫码服务 → 下发 check → 等结果;连不上 NVR 的换下一台。 * * @param {object} params * @param {number} params.subjectId * @param {string} params.code 运单号 * @param {number} [params.waitMs] * @return {Promise} 见 controller 的注释 */ async checkVideo({ subjectId, code, waitMs = DEFAULT_WAIT_MS }) { const plan = await this.ctx.service.pack.query({ subjectId, code }); const streams = (plan && plan.streams) || []; // 没有流计划:连"该查哪台 NVR 的哪个通道"都算不出来,无需惊动设备 if (streams.length === 0) { return { state: 'no-plan', hasVideo: false }; } const scanners = await this.onlineScanners(subjectId); if (scanners.length === 0) { return { state: 'no-device', hasVideo: null }; } const stream = streams[0]; let credential; try { credential = await this.ctx.service.nvr.credentialOf(stream.nvrId, subjectId); } catch (err) { return { state: 'no-credential', hasVideo: null, message: err.message }; } if (!credential.password) { return { state: 'no-credential', hasVideo: null, message: '录像机没有保存密码' }; } const payload = { nvrId: stream.nvrId, nvrHost: credential.host, nvrPort: credential.port, username: credential.username, password: credential.password, channelNo: stream.channelNo, startTime: stream.startTime, endTime: stream.endTime, }; const startedAt = Date.now(); let lastError = null; for (const scanner of scanners) { let task; try { task = await this.enqueue(scanner.id, 'check', payload); } catch (err) { lastError = err.message; continue; } const result = await this.waitResult(task.id, waitMs); if (!result) { lastError = '设备没有响应'; continue; } // 设备明确说连不上(或参数被拒):换下一台试 if (result.ok === false) { lastError = result.error || '设备执行失败'; continue; } return { state: 'ok', hasVideo: Boolean(result.hasRecord), frames: Number(result.frames) || 0, source: result.source || '', message: result.error || null, scannerSn: scanner.sn, elapsedMs: Date.now() - startedAt, }; } return { state: 'no-device', hasVideo: null, message: lastError }; } } function sleep(ms) { return new Promise(resolve => setTimeout(resolve, ms)); } module.exports = EdgeTaskService;