From a998a0d0f7dbec246ff22752af7870a7146765bd Mon Sep 17 00:00:00 2001 From: SunYF <123@hard_man.com> Date: Mon, 16 Nov 2026 19:42:22 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20AGV=E7=8A=B6=E6=80=81=E5=AE=9E=E6=97=B6?= =?UTF-8?q?=E6=8E=A8=E9=80=81=E4=B8=8E=E5=8F=97=E6=8E=A7=E5=BC=82=E5=B8=B8?= =?UTF-8?q?=E5=A4=84=E7=BD=AE=20+=20rcs-dps=E7=8A=B6=E6=80=81=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=E7=8B=AC=E7=AB=8B=E9=85=8D=E7=BD=AE=E4=B8=8E=E6=97=A5?= =?UTF-8?q?=E5=BF=97=E8=90=BD=E7=9B=98=E4=BF=AE=E5=A4=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- bj_power_mes/bj_power_mes.go | 8 + bj_power_mes/etc/bj_power_mes-api.yaml | 6 +- bj_power_mes/frontend/src/pages/AgvManual.vue | 219 ++++++++++++++++-- bj_power_mes/internal/agv/client.go | 152 ++++++++---- bj_power_mes/internal/config/config.go | 15 +- .../internal/handler/production/agv.go | 33 ++- .../internal/handler/production/agv_ws.go | 44 ++++ .../internal/handler/routes_production.go | 7 + bj_power_mes/internal/logic/agv.go | 74 ++++-- bj_power_mes/internal/netutil/localip.go | 54 +++++ bj_power_mes/internal/plc/logging.go | 40 ++-- .../internal/wmsclient/transport_logging.go | 12 +- bj_power_mes/internal/ws/agv_hub.go | 178 ++++++++++++++ bj_power_mes/public/index.html | 2 +- .../internal/mesclient/transport_logging.go | 12 +- bj_power_wms/internal/netutil/localip.go | 54 +++++ bj_power_workstation/internal/mes/client.go | 16 +- .../internal/netutil/localip.go | 54 +++++ 18 files changed, 861 insertions(+), 119 deletions(-) create mode 100644 bj_power_mes/internal/handler/production/agv_ws.go create mode 100644 bj_power_mes/internal/netutil/localip.go create mode 100644 bj_power_mes/internal/ws/agv_hub.go create mode 100644 bj_power_wms/internal/netutil/localip.go create mode 100644 bj_power_workstation/internal/netutil/localip.go diff --git a/bj_power_mes/bj_power_mes.go b/bj_power_mes/bj_power_mes.go index 7b2fccf..524a370 100644 --- a/bj_power_mes/bj_power_mes.go +++ b/bj_power_mes/bj_power_mes.go @@ -694,6 +694,14 @@ func runServe(c config.Config, asService bool) { ) defer server.Stop() + // 2026-11-16 联调:rest.MustNewServer 内部 logx.SetUp(RestConf.Log) 会用 console writer + // 覆盖 main 里 SetWriter 装的按天文件 writer(setupOnce 全程只此一次,之后无人再覆盖), + // 导致服务启动后所有业务日志只进控制台不落文件(实验复现实锤)。 + // 必须在 server 创建后把文件 writer 装回去,此后全量业务日志正常落 logs/。 + if c.Logger.Filename != "" { + gologx.SetWriter(logx.NewLogger(c.Logger)) + } + ctx := svc.NewServiceContext(c) // 扫码中间件(键盘 HID 注入):默认关闭(Scanner.Enabled=false),需在 yaml 启用并重启。 diff --git a/bj_power_mes/etc/bj_power_mes-api.yaml b/bj_power_mes/etc/bj_power_mes-api.yaml index 52ffb25..f426d4a 100644 --- a/bj_power_mes/etc/bj_power_mes-api.yaml +++ b/bj_power_mes/etc/bj_power_mes-api.yaml @@ -52,10 +52,12 @@ Plc: Port: 102 # 海康 AGV(RCS-Lite V1.5) 对接(2026-10-17 由 RCS-2000 改为 RCS-Lite 1.5):无签名鉴权 -# 未接真实 RCS-Lite 前保持 mock(EnableMock: true);现场对接时填 EnableMock: false + BaseURL(默认端口 8182,含 /rCMS/services/rest/hikRpcService) +# 未接真实 RCS-Lite 前保持 mock(EnableMock: true);现场对接时填 EnableMock: false + BaseURL(默认端口 8182,含 /rcms/services/rest/hikRpcService,小写 rcms,客户 postman 实测大写会 404) Agv: EnableMock: false - BaseURL: "http://192.168.22.13:8182/rCMS/services/rest/hikRpcService" + BaseURL: "http://192.168.22.13:8182/rcms/services/rest/hikRpcService" + # 车辆状态查询是 rcs-dps 独立服务(文档 §3.1.7),路径前缀与任务接口不同,必须单独配置 + AgvStatusURL: "http://192.168.22.13:8182/rcms-dps/rest" CarrierCode: "" MapCode: "" Priority: "1" diff --git a/bj_power_mes/frontend/src/pages/AgvManual.vue b/bj_power_mes/frontend/src/pages/AgvManual.vue index b4d2997..a8b3201 100644 --- a/bj_power_mes/frontend/src/pages/AgvManual.vue +++ b/bj_power_mes/frontend/src/pages/AgvManual.vue @@ -6,7 +6,7 @@ // 界面不出现任何让用户选车号的下拉框/输入框;车号只作状态展示。 // 人工派车白名单硬拦:只允许库房接驳台 JBT21 与 7 个虚拟点位,GW* 工位接驳台一律不可选。 defineOptions({ name: 'AgvManual' }) -import { computed, onMounted, reactive, ref } from 'vue' +import { computed, onMounted, onBeforeUnmount, reactive, ref } from 'vue' import { ElMessage, ElMessageBox } from 'element-plus' import request from '../utils/request' import { agvManualAllowed, agvTemplateOf } from '../utils/agvPoints' @@ -18,7 +18,6 @@ const canManual = computed(() => can('produce.agv.manual')) const points = ref([]) const chains = ref([]) const busy = ref(false) -const loading = ref(false) const selected = ref('') const activeChain = reactive({ chainNo: '', agvCode: '', current: '', segments: [], status: '' }) @@ -45,10 +44,47 @@ const statusText = computed(() => { if (s === 'ARRIVED') return '已到位 · 可前往下一站' if (s === '2') return '行驶中 · 请等待到位' if (s === '1' || s === 'PENDING') return '已派车 · 等待系统分车' + if (s === 'FAILED') return '任务下发失败 · 需处置' if (s === '9') return '本段已完成' return '用车中' }) +// 未到位原因诊断:按当前段的真实状态给出准确原因 + 正确处置,绝不直接给强制结束按钮。 +// 只有当用户判断现场实物已处理、系统状态卡死时,才引导到「用车状态」区的受控入口。 +function notArrivedReason(s) { + if (s === '2') return { + why: '车辆正在前往目标点的途中(行驶中),尚未到达。', + what: '这是正常过程,请等待状态变为「已到位 · 可前往下一站」后再结束用车。状态自动更新,无需手动刷新。' + } + if (s === '1' || s === 'PENDING') return { + why: '任务已创建,海康调度系统尚未分配到具体车辆。', + what: '请稍等,状态变为「已到位」后再结束用车;如长时间(超过 1 分钟)无变化,检查与海康 RCS 的网络连接。' + } + if (s === 'FAILED') return { + why: '本段任务下发失败(断网期间下发或海康返回错误),车辆不会前往目标点。', + what: '请到「AGV任务」列表找到该车重试下发;若现场货物已由人工处理、不打算再派车,再使用「用车状态」区的异常处理入口。' + } + if (!s) return { + why: '系统与海康调度系统通讯中断,当前无法确认车辆真实状态。', + what: '请先确认本机网络已连通内网、海康 RCS 服务正常;状态恢复后再结束用车。' + } + return { + why: `当前段状态为 ${s},系统判定车辆未到位。`, + what: '请到现场确认车辆与货物实际位置;确认实物已处理但系统卡死时,再使用「用车状态」区的异常处理入口。' + } +} + +async function showNotArrivedDiagnosis() { + const d = notArrivedReason(activeChain.status) + try { + await ElMessageBox.alert( + `无法结束用车。\n\n【原因】${d.why}\n\n【怎么处理】${d.what}\n\n只有当你已在现场确认实物处理完毕、但系统状态仍卡住时,才需要到上方「用车状态」处点「异常处理」,且必须说明原因并二次确认。`, + '车辆尚未到位', + { confirmButtonText: '我知道了', type: 'warning' } + ) + } catch { /* ignore */ } +} + function pointLabel(code) { if (!code) return '—' const p = (points.value || []).find((x) => x.positionCode === code) @@ -65,8 +101,65 @@ async function loadPoints() { async function loadChains() { try { const d = await request.get('/agv/chain/list') - chains.value = d?.list || [] - } catch { chains.value = [] } + applyChains(d?.list || []) + } catch { applyChains([]) } +} + +// AGV 状态实时推送:WebSocket 长连接,后端拉到 RCS 状态变化即推;无需手动刷新。 +// (沿用全局待办 WS 同一鉴权方式:token 走 query,后端 tokenx.Parse 自校验。) +let agvWs = null +let agvWsReconnectTimer = null +let agvWsRetry = 0 +let agvWsAlive = true + +function agvWsUrl() { + const token = localStorage.getItem('token') || '' + const proto = window.location.protocol === 'https:' ? 'wss' : 'ws' + return `${proto}://${window.location.host}/api/v1/agv/ws?token=${encodeURIComponent(token)}` +} + +function connectAgvWs() { + if (!agvWsAlive || !localStorage.getItem('token')) return + let ws + try { + ws = new WebSocket(agvWsUrl()) + } catch { + scheduleAgvWsReconnect() + return + } + agvWs = ws + ws.onopen = () => { agvWsRetry = 0 } + ws.onmessage = (ev) => { + try { + const msg = JSON.parse(ev.data) + if (msg && Array.isArray(msg.chains)) applyChains(msg.chains) + } catch { /* 忽略单条异常推送 */ } + } + ws.onclose = () => { + if (agvWs === ws) agvWs = null + if (agvWsAlive) scheduleAgvWsReconnect() + } +} + +function scheduleAgvWsReconnect() { + if (agvWsReconnectTimer || !agvWsAlive) return + const delay = Math.min(30000, 2000 * Math.pow(2, agvWsRetry)) + agvWsRetry = Math.min(agvWsRetry + 1, 5) + agvWsReconnectTimer = setTimeout(() => { + agvWsReconnectTimer = null + connectAgvWs() + }, delay) +} + +function closeAgvWs() { + agvWsAlive = false + if (agvWsReconnectTimer) { clearTimeout(agvWsReconnectTimer); agvWsReconnectTimer = null } + if (agvWs) { try { agvWs.close() } catch { /* ignore */ } agvWs = null } +} + +// 把链快照写进界面状态(WS 推送与 loadChains 共用)。 +function applyChains(list) { + chains.value = list || [] const c = (chains.value || []).find((x) => x.active) || null const last = c?.segments?.length ? c.segments[c.segments.length - 1] : null Object.assign(activeChain, { @@ -78,14 +171,8 @@ async function loadChains() { }) } -async function refresh() { - loading.value = true - try { await request.post('/agv/refresh', {}) } catch { /* 请求层已提示 */ } - await Promise.all([loadChains(), loadPoints()]) - loading.value = false -} - -// 刷新 RCS 状态并回写车号:开始用车后、每次前往下一站前由系统自动做,用户无需手动刷新 +// 下发后立即主动拉一次 RCS 拿车号(程序触发,非界面手动刷新按钮): +// 车号由 RCS 分配、需一次 queryTaskStatus 回写;后续到位/失败由 WS 自动推送,无需用户点刷新。 async function syncCar() { try { await request.post('/agv/refresh', {}) } catch { /* 请求层已提示 */ } await loadChains() @@ -156,13 +243,70 @@ async function endUse() { selected.value = '' Object.assign(activeChain, { chainNo: '', agvCode: '', current: '', segments: [], status: '' }) await loadChains() + } catch (e) { + const msg = e?.message || e?.response?.data?.message || String(e) + // 未到位:只诊断说清原因与正确处置,绝不在这里直接诱导强制结束。 + // 强制结束是受控入口(见用车状态区),需主动进入+选原因+二次确认。 + if (msg.includes('尚未到位')) { + await showNotArrivedDiagnosis() + } } finally { busy.value = false } } +// ===== 异常处置(受控入口,故意不顺手)===== +// 只在「用车状态」区显示一个小链接,需主动点进;进入后必须①读危险说明②选原因③勾选现场已确认, +// 三步齐全才允许二次确认。目的:杜绝"报错→顺手点强制结束"的诱导操作。 +const forceDialog = ref(false) +const forceReason = ref('') +const forceAck = ref(false) +const forceReasons = [ + { value: 'unloaded', label: '货物已人工卸下,车辆已停稳在安全位置' }, + { value: 'dispatch_failed', label: '任务下发失败,车辆未载货、停在原地' }, + { value: 'network_lost', label: '断网期间实物已由现场人员处理完毕' }, + { value: 'other', label: '其它(已在备注/工单中说明现场处置情况)' } +] + +function openForceDialog() { + if (!canManual.value) { ElMessage.error('没有人工派车的操作权限'); return } + if (!activeChain.chainNo) { ElMessage.warning('当前没有进行中的用车任务'); return } + forceReason.value = '' + forceAck.value = false + forceDialog.value = true +} + +async function submitForceEnd() { + if (!forceReason.value) { ElMessage.warning('请先选择现场处置情况'); return } + if (!forceAck.value) { ElMessage.warning('请先确认现场实物已处理'); return } + // 二次确认:把所选原因回填,让人再核实一次自己刚才的判断。 + const chosen = forceReasons.find((r) => r.value === forceReason.value)?.label || forceReason.value + try { + await ElMessageBox.confirm( + `即将解除系统死锁。你选择的处置情况是:\n「${chosen}」\n\n此操作只清除系统内的任务状态、释放点位锁;不会通知海康、不会让车辆移动。请再次确认现场货物已卸、车辆已停稳,否则后续派车可能撞车或压货。`, + '第二次确认 · 异常处置', + { confirmButtonText: '确认,解除系统状态', cancelButtonText: '再想想', type: 'error' } + ) + } catch { return } + busy.value = true + try { + await request.post('/agv/chain/force-end', { chainNo: activeChain.chainNo, reason: chosen }) + ElMessage.success('系统任务状态已解除。请继续到现场核实实物状态。') + forceDialog.value = false + selected.value = '' + Object.assign(activeChain, { chainNo: '', agvCode: '', current: '', segments: [], status: '' }) + await loadChains() + } catch { /* 请求层已提示 */ } + finally { busy.value = false } +} + onMounted(async () => { await Promise.all([loadPoints(), loadChains()]) + connectAgvWs() +}) + +onBeforeUnmount(() => { + closeAgvWs() }) @@ -181,12 +325,16 @@ onMounted(async () => {
用车状态 {{ statusText }} + +
- 刷新状态 + 状态自动更新 + title="开始用车:选一个点位点「开始用车」,系统自动分配一辆车。前往下一站:再选点位,全程固定用这一辆。结束用车:点「结束用车」释放车辆。全程不需要你选车号,工位接驳台不可选。车辆到位/失败会自动更新,无需手动刷新。" />
选择目的地
@@ -228,6 +376,35 @@ onMounted(async () => { + + + + +
+

+ 此操作只清除系统内的任务状态、释放点位锁,让界面恢复可用;它不会通知海康 RCS、不会让车辆移动或回充, + 车辆在物理上仍停在当前位置。若货物实际未卸下,后续派车可能撞车、压货或掉货,后果由现场处置决定。 +

+

仅在现场实物已由人员处理完毕、但系统状态卡死时使用。正常未到位请点「返回」,等待车辆到位。

+ +
① 请选择现场实际处置情况(必选)
+ + {{ r.label }} + + +
② 现场实物确认(必勾)
+ + 我已到现场确认:货物已卸下、车辆已停稳,或车辆未载货停在原地,解除系统状态不会造成碰撞或货损。 + +
+ +
@@ -242,7 +419,19 @@ onMounted(async () => { .status-value { font-size: 22px; line-height: 1.35; color: #303133; } .status-value.unknown { color: #e6a23c; } .status-value.running { color: #67c23a; } -.refresh-btn { margin-left: auto; font-size: 17px; } +.live-tag { margin-left: auto; font-size: 14px; color: #67c23a; } +/* 异常处置入口:低调,不诱导点击 */ +.force-entry { + align-self: flex-start; margin-top: 4px; padding: 2px 0; border: none; background: none; + color: #909399; font-size: 13px; text-decoration: underline; cursor: pointer; font-family: inherit; +} +.force-entry:hover { color: #f56c6c; } +.force-warn { font-size: 15px; } +.force-body { padding: 6px 2px; } +.force-impact { font-size: 15px; line-height: 1.7; color: #606266; margin: 10px 0; } +.force-impact strong { color: #f56c6c; } +.force-step { font-size: 16px; font-weight: 700; color: #303133; margin: 18px 0 8px; } +.force-reasons { display: flex; flex-direction: column; gap: 6px; } .hint-bar { font-size: 15px; margin-bottom: 16px; } .section-title { font-size: 19px; font-weight: 700; margin: 16px 0 10px; } .point-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(150px, 1fr)); gap: 14px; } diff --git a/bj_power_mes/internal/agv/client.go b/bj_power_mes/internal/agv/client.go index b946786..a24c36c 100644 --- a/bj_power_mes/internal/agv/client.go +++ b/bj_power_mes/internal/agv/client.go @@ -1,7 +1,8 @@ // Package agv 海康 AGV 调度系统(RCS-Lite V1.5) 对接客户端(2026-10-17 由 RCS-2000 改为 RCS-Lite 1.5)。 // 能力:生成搬运任务(genAgvSchedulingTask)、查询任务状态(queryTaskStatus)、取消任务(cancelTask)。 // 协议详见《AGV海康litev1.5.md》:无签名;所有参数统一字符串;成功 code=="0"。 -// 完整请求路径 = BaseURL(已含 /rCMS/services/rest/hikRpcService) + 业务路径。 +// 完整请求路径 = BaseURL(已含 /rcms/services/rest/hikRpcService,小写) + 业务路径; +// 车辆状态查询例外:走 AgvStatusURL(rcms-dps/rest 独立服务) + /queryAgvStatus。 // 未配置真实 RCS(BaseURL 为空) 或 EnableMock=true 时走 Mock 客户端。 package agv @@ -12,6 +13,7 @@ import ( "fmt" "io" "net/http" + "net/url" "strings" "time" @@ -19,8 +21,12 @@ import ( "github.com/zeromicro/go-zero/core/logx" "bj_power_mes/internal/config" + "bj_power_mes/internal/netutil" ) +// commTag 本机 IP 前缀(进程启动解析一次),断网排查时可一眼看出日志来自哪台机器。 +var commTag = netutil.Tag() + // Client AGV 调度客户端抽象 type Client interface { // SubmitTask 下发搬运任务 fromDock -> toDock。taskCode 为我方任务单号(透传给 RCS 便于回查)。 @@ -65,34 +71,91 @@ func New(cfg config.AgvConf) Client { // ---------- 请求与响应(真实海康 RCS-Lite) ---------- type realClient struct { - cfg config.AgvConf - hc *http.Client - carrier string + cfg config.AgvConf + hc *http.Client + carrier string + statusBase string // 车辆状态(rcms-dps/rest)独立服务地址 } func newRealClient(cfg config.AgvConf) *realClient { return &realClient{ - cfg: cfg, - hc: &http.Client{Timeout: 15 * time.Second}, - carrier: cfg.CarrierCode, + cfg: cfg, + hc: &http.Client{Timeout: 15 * time.Second}, + carrier: cfg.CarrierCode, + statusBase: resolveStatusBase(cfg), } } -// url 拼接 RCS-Lite 基础地址 + 业务路径(BaseURL 已含 /rCMS/services/rest/hikRpcService)。 +// resolveStatusBase 车辆状态(rcms-dps/rest)地址:优先显式配置;留空则从 BaseURL 取 scheme://host 推导。 +// 推导用 net/url 解析(非正则),如 http://IP:8182/rcms/services/... → http://IP:8182/rcms-dps/rest。 +func resolveStatusBase(cfg config.AgvConf) string { + if s := strings.TrimSpace(cfg.AgvStatusURL); s != "" { + return strings.TrimRight(s, "/") + } + u, err := url.Parse(cfg.BaseURL) + if err != nil || u.Scheme == "" || u.Host == "" { + return "" + } + return u.Scheme + "://" + u.Host + "/rcms-dps/rest" +} + +// url 拼接 RCS-Lite 任务接口地址 + 业务路径(BaseURL 已含 /rcms/services/rest/hikRpcService,小写)。 func (c *realClient) url(path string) string { return strings.TrimRight(c.cfg.BaseURL, "/") + path } +// statusURL 拼接车辆状态地址 + 业务路径(rcms-dps/rest 独立服务)。 +func (c *realClient) statusURL(path string) string { + return strings.TrimRight(c.statusBase, "/") + path +} + +// flexString 兼容 RCS 字段「有时返回 JSON 字符串、有时返回数字」的情况。 +// 协议文档写"参数统一字符串",但实测响应 code 返回数字 1006/-1、status 也可能是数字, +// 用 string 直接反序列化会报 cannot unmarshal number into Go struct field ... of type string。 +// 本类型把字符串/数字/布尔/null 统一收成字符串,下游按字符串比较即可。不使用正则。 +type flexString string + +func (f *flexString) UnmarshalJSON(b []byte) error { + if len(b) == 0 { + *f = "" + return nil + } + if b[0] == '"' { // JSON 字符串 + var s string + if err := json.Unmarshal(b, &s); err != nil { + return err + } + *f = flexString(s) + return nil + } + var v any // 数字/布尔/null 按字面量收 + if err := json.Unmarshal(b, &v); err != nil { + return err + } + if v == nil { + *f = "" + return nil + } + *f = flexString(fmt.Sprint(v)) + return nil +} + // envelope RCS-Lite 统一响应信封(§1.4):code 必填、message 必填、reqCode 回传、data 选填。 type envelope struct { - Code string `json:"code"` + Code flexString `json:"code"` Message string `json:"message"` ReqCode string `json:"reqCode"` Data json.RawMessage `json:"data"` } -// call POST 到 RCS-Lite 并解析信封。成功判定 code=="0";out 非空时把 data 反序列化进去。 +// call POST 到 RCS-Lite 任务接口(BaseURL)并解析信封。 func (c *realClient) call(ctx context.Context, path string, payload map[string]any, out any) error { + return c.callAt(ctx, c.url(path), payload, out) +} + +// callAt POST 到完整 URL 并解析信封。成功判定 code=="0";out 非空时把 data 反序列化进去。 +// 车辆状态(rcms-dps)等独立服务接口用本方法,避免误挂到任务接口 BaseURL 下。 +func (c *realClient) callAt(ctx context.Context, reqURL string, payload map[string]any, out any) error { if payload == nil { payload = map[string]any{} } @@ -107,29 +170,28 @@ func (c *realClient) call(ctx context.Context, path string, payload map[string]a if err != nil { return err } - reqURL := c.url(path) // 2026-11-16 联调:AGV 全量 HTTP 交互落日志(请求 URL/报文 + 响应状态/响应体),grep "[AGV]" 可见。 - logx.WithContext(ctx).Infof("[AGV] --> POST %s payload=%s", reqURL, string(body)) + logx.WithContext(ctx).Infof("[AGV]"+commTag+" --> POST %s payload=%s", reqURL, string(body)) req, err := http.NewRequestWithContext(ctx, http.MethodPost, reqURL, bytes.NewReader(body)) if err != nil { - logx.WithContext(ctx).Errorf("[AGV] <-- build request error url=%s err=%v", reqURL, err) + logx.WithContext(ctx).Errorf("[AGV]"+commTag+" <-- build request error url=%s err=%v", reqURL, err) return err } req.Header.Set("Content-Type", "application/json;charset=UTF-8") resp, err := c.hc.Do(req) if err != nil { - logx.WithContext(ctx).Errorf("[AGV] <-- transport error url=%s err=%v", reqURL, err) + logx.WithContext(ctx).Errorf("[AGV]"+commTag+" <-- transport error url=%s err=%v", reqURL, err) return err } defer resp.Body.Close() raw, err := io.ReadAll(resp.Body) if err != nil { - logx.WithContext(ctx).Errorf("[AGV] <-- read body error url=%s httpStatus=%d err=%v", reqURL, resp.StatusCode, err) + logx.WithContext(ctx).Errorf("[AGV]"+commTag+" <-- read body error url=%s httpStatus=%d err=%v", reqURL, resp.StatusCode, err) return err } - logx.WithContext(ctx).Infof("[AGV] <-- HTTP %d url=%s body=%s", resp.StatusCode, reqURL, string(raw)) + logx.WithContext(ctx).Infof("[AGV]"+commTag+" <-- HTTP %d url=%s body=%s", resp.StatusCode, reqURL, string(raw)) if resp.StatusCode >= 400 { return fmt.Errorf("agv http %d: %s", resp.StatusCode, string(raw)) } @@ -139,7 +201,7 @@ func (c *realClient) call(ctx context.Context, path string, payload map[string]a } // 成功码固定字符串 "0"(§1.5 结果码定义) if env.Code != "0" { - logx.WithContext(ctx).Errorf("[AGV] <-- biz error url=%s code=%s message=%s reqCode=%v", reqURL, env.Code, env.Message, payload["reqCode"]) + logx.WithContext(ctx).Errorf("[AGV]"+commTag+" <-- biz error url=%s code=%s message=%s reqCode=%v", reqURL, env.Code, env.Message, payload["reqCode"]) return fmt.Errorf("agv code=%s message=%s", env.Code, env.Message) } if out != nil && len(env.Data) > 0 { @@ -203,12 +265,12 @@ func (c *realClient) SubmitTask(ctx context.Context, taskCode, fromDock, toDock, return taskCode, nil } -// queryTaskData queryTaskStatus 的 data 列表项 +// queryTaskData queryTaskStatus 的 data 列表项(字段兼容字符串/数字) type queryTaskData struct { - TaskCode string `json:"taskCode"` - TaskStatus string `json:"taskStatus"` - AgvCode string `json:"agvCode"` - TaskTyp string `json:"taskTyp"` + TaskCode flexString `json:"taskCode"` + TaskStatus flexString `json:"taskStatus"` + AgvCode flexString `json:"agvCode"` + TaskTyp flexString `json:"taskTyp"` } // QueryTask 实现 Client:查询任务状态(queryTaskStatus)。 @@ -225,8 +287,8 @@ func (c *realClient) QueryTask(ctx context.Context, taskCode string) (string, st return "", "", err } for _, d := range out.Data { - if d.TaskCode == taskCode && d.TaskStatus != "" { - return d.TaskStatus, d.AgvCode, nil + if string(d.TaskCode) == taskCode && d.TaskStatus != "" { + return string(d.TaskStatus), string(d.AgvCode), nil } } return "1", "", nil @@ -245,18 +307,20 @@ func (c *realClient) CancelTask(ctx context.Context, taskCode, reason string) er return c.call(ctx, "/cancelTask", payload, nil) } -// queryAgvStatusData 3.1.7 单条车辆状态 data 项 +// queryAgvStatusData 3.1.7 单条车辆状态 data 项(字段兼容字符串/数字) type queryAgvStatusData struct { - RobotCode string `json:"robotCode"` - Battery string `json:"battery"` - Status string `json:"status"` - PodCode string `json:"podCode"` - PosX string `json:"posX"` - PosY string `json:"posY"` - Stop string `json:"stop"` + RobotCode flexString `json:"robotCode"` + Battery flexString `json:"battery"` + Status flexString `json:"status"` + PodCode flexString `json:"podCode"` + PosX flexString `json:"posX"` + PosY flexString `json:"posY"` + Stop flexString `json:"stop"` } // QueryAgvStatus 实现 Client:3.1.7 只读获取全部车辆状态。 +// 走 rcs-dps/rest 独立服务(§3.1.7 调用路径 http://IP:8182/rcms-dps/rest/queryAgvStatus), +// 不是 hikRpcService 任务接口——此前挂到任务 BaseURL 下导致 404。 // mapShortName 取配置 MapCode(多地图场景必填;单地图可空,RCS 侧默认)。 func (c *realClient) QueryAgvStatus(ctx context.Context) ([]AgvVehicle, error) { payload := map[string]any{ @@ -265,19 +329,19 @@ func (c *realClient) QueryAgvStatus(ctx context.Context) ([]AgvVehicle, error) { var out struct { Data []queryAgvStatusData `json:"data"` } - if err := c.call(ctx, "/queryAgvStatus", payload, &out); err != nil { + if err := c.callAt(ctx, c.statusURL("/queryAgvStatus"), payload, &out); err != nil { return nil, err } vs := make([]AgvVehicle, 0, len(out.Data)) for _, d := range out.Data { vs = append(vs, AgvVehicle{ - RobotCode: d.RobotCode, - Battery: atof(d.Battery), - Status: d.Status, - PodCode: d.PodCode, - PosX: atof(d.PosX), - PosY: atof(d.PosY), - Stop: d.Stop == "1", + RobotCode: string(d.RobotCode), + Battery: atof(string(d.Battery)), + Status: string(d.Status), + PodCode: string(d.PodCode), + PosX: atof(string(d.PosX)), + PosY: atof(string(d.PosY)), + Stop: d.Stop == "1" || d.Stop == "true", }) } return vs, nil @@ -300,24 +364,24 @@ func newMockClient() *mockClient { return &mockClient{} } func (m *mockClient) SubmitTask(ctx context.Context, taskCode, fromDock, toDock, carrierCode, templateType, agvCode string) (string, error) { // 模拟立即成功下发,返回我方 taskCode(与真实客户端一致,HikTaskCode=taskNo) - logx.WithContext(ctx).Infof("[AGV][MOCK] SubmitTask taskCode=%s %s->%s template=%s agvCode=%s(模拟下发成功,未发真实 HTTP)", taskCode, fromDock, toDock, templateType, agvCode) + logx.WithContext(ctx).Infof("[AGV]"+commTag+"[MOCK] SubmitTask taskCode=%s %s->%s template=%s agvCode=%s(模拟下发成功,未发真实 HTTP)", taskCode, fromDock, toDock, templateType, agvCode) return taskCode, nil } func (m *mockClient) QueryTask(ctx context.Context, taskCode string) (string, string, error) { // 模拟:MOCK 任务一律视为已结束,便于离线联调观察"待搬运→已到位";模拟模式无真实分车,agvCode 为空 - logx.WithContext(ctx).Infof("[AGV][MOCK] QueryTask taskCode=%s(模拟返回已结束)", taskCode) + logx.WithContext(ctx).Infof("[AGV]"+commTag+"[MOCK] QueryTask taskCode=%s(模拟返回已结束)", taskCode) return "9", "", nil } func (m *mockClient) CancelTask(ctx context.Context, taskCode, reason string) error { - logx.WithContext(ctx).Infof("[AGV][MOCK] CancelTask taskCode=%s reason=%s(模拟取消成功)", taskCode, reason) + logx.WithContext(ctx).Infof("[AGV]"+commTag+"[MOCK] CancelTask taskCode=%s reason=%s(模拟取消成功)", taskCode, reason) return nil } // QueryAgvStatus Mock:返回两台示例车(一台空闲、一台执行中),便于联调展示。 func (m *mockClient) QueryAgvStatus(ctx context.Context) ([]AgvVehicle, error) { - logx.WithContext(ctx).Infof("[AGV][MOCK] QueryAgvStatus(模拟返回样例车 9001/9002)") + logx.WithContext(ctx).Infof("[AGV]" + commTag + "[MOCK] QueryAgvStatus(模拟返回样例车 9001/9002)") return []AgvVehicle{ {RobotCode: "9001", Battery: 99, Status: "4", PodCode: "0", PosX: 20000, PosY: 20000, Stop: false}, {RobotCode: "9002", Battery: 78, Status: "2", PodCode: "100001", PosX: 35000, PosY: 12000, Stop: false}, diff --git a/bj_power_mes/internal/config/config.go b/bj_power_mes/internal/config/config.go index 4b11229..7f9edb6 100644 --- a/bj_power_mes/internal/config/config.go +++ b/bj_power_mes/internal/config/config.go @@ -61,8 +61,8 @@ type PlcConf struct { Enable bool `json:",default=false"` Host string `json:",default=127.0.0.1"` Port int `json:",default=102"` - Rack int `json:",default=0"` // S7 机架号(1200=0,300=0) - Slot int `json:",default=1"` // S7 槽号(1200=1,300=2) + Rack int `json:",default=0"` // S7 机架号(1200=0,300=0) + Slot int `json:",default=1"` // S7 槽号(1200=1,300=2) // DoneByte/DoneBit 工艺完成信号位(PLC 完成上一条下发后置位,MES 读此位决定是否下发下一条)。 // 待现场 PLC 点位表确认;未配置时 QueryDone 安全返回 false(不下发下一条,不误进)。 DoneByte int `json:",default=-1"` @@ -72,11 +72,12 @@ type PlcConf struct { // AgvConf 海康 AGV(RCS-Lite V1.5) 调度系统对接(2026-10-17 由 RCS-2000 改为 RCS-Lite 1.5)。 // RCS-Lite 无签名鉴权;未配置 BaseURL 或 EnableMock=true 时,使用 mock 客户端(模拟下发成功/到位),便于离线联调。 type AgvConf struct { - EnableMock bool `json:",default=true"` // 是否模拟(未接真实 RCS-Lite 前保持 true) - BaseURL string `json:",default=http://127.0.0.1:8182/rCMS/services/rest/hikRpcService"` // RCS-Lite 服务地址(含 /rCMS/services/rest/hikRpcService,默认端口 8182) - CarrierCode string `json:",default=DEFAULT"` // 默认载具/托盘编号(选填,下发时作为 podCode) - MapCode string `json:",default="` // 地图编号(选填,RCS-Lite 多地图场景使用) - Priority string `json:",default=1"` // 任务优先级(字符串 1-127,默认 1) + EnableMock bool `json:",default=true"` // 是否模拟(未接真实 RCS-Lite 前保持 true) + BaseURL string `json:",default=http://127.0.0.1:8182/rcms/services/rest/hikRpcService"` // RCS-Lite 任务接口地址(含 /rcms/services/rest/hikRpcService,小写 rcms,客户 postman 实测大写会 404) + AgvStatusURL string `json:",optional"` // 车辆状态接口地址(rcs-dps 独立服务,如 http://IP:8182/rcms-dps/rest;留空则由 BaseURL 推导) + CarrierCode string `json:",default=DEFAULT"` // 默认载具/托盘编号(选填,下发时作为 podCode) + MapCode string `json:",default="` // 地图编号(选填,RCS-Lite 多地图场景使用) + Priority string `json:",default=1"` // 任务优先级(字符串 1-127,默认 1) // 任务类型编号 = RCS-Lite 任务模板载体(接口文档 2.1.1 taskTyp:与 RCS 端配置的主任务类型编号一致, // 模板绑定在该编号上,错误码 1005/1044 即模板读取/配置失败)。 // 2026-11-13 拍板:现场模板 B01=举升(目标点为 JBT21 或工位接驳台)、B02=移动(A1-A4/XW/XT/KF1/GW1Z 等无接驳台点位)。 diff --git a/bj_power_mes/internal/handler/production/agv.go b/bj_power_mes/internal/handler/production/agv.go index 3db44c3..eade823 100644 --- a/bj_power_mes/internal/handler/production/agv.go +++ b/bj_power_mes/internal/handler/production/agv.go @@ -305,6 +305,31 @@ func AgvChainEndHandler(svcCtx *svc.ServiceContext) http.HandlerFunc { } } +// AgvChainForceEndHandler POST /agv/chain/force-end 强制结束安全阀: +// 人工确认现场实物已处置后,仅清系统死锁状态(段置终态+释放点位锁+留痕), +// 不调用海康任何接口、不下发任何物理动作。风险由前端确认弹窗告知。 +func AgvChainForceEndHandler(svcCtx *svc.ServiceContext) http.HandlerFunc { + return func(w http.ResponseWriter, r *http.Request) { + var req struct { + ChainNo string `json:"chainNo"` + Reason string `json:"reason"` // 现场实际处置情况(受控入口必选),仅用于留痕 + } + if err := httpx.ParseJSON(r, &req); err != nil || req.ChainNo == "" { + httpx.BadRequest(w, "缺少任务链号(chainNo)") + return + } + operator := r.Header.Get("X-Username") + if operator == "" { + operator = "dispatcher" + } + if err := logic.New(svcCtx).AgvChainForceEnd(r.Context(), req.ChainNo, operator, req.Reason); err != nil { + httpx.Fail(w, 3315, err.Error()) + return + } + httpx.OkMessage(w, "已强制结束,系统状态已解除;请确认现场实物已处理", nil) + } +} + // AgvChainListHandler GET /agv/chain/list 手动链列表(任务进行中面板:链号/锁定车/节点/进行中)。 func AgvChainListHandler(svcCtx *svc.ServiceContext) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { @@ -319,9 +344,11 @@ func AgvChainListHandler(svcCtx *svc.ServiceContext) http.HandlerFunc { // AgvPointLockHandler POST /agv/points/:id/lock —— 点位锁定管理(派车锁 2026-11-06 拍板): // body {locked bool, reason string, clearForcePick bool} -// locked=true → 人工锁定(reason 必填,locked_by=manual,仅人工解锁); -// locked=false → 人工解锁(含 JBT21 手动解锁、系统锁人工释放); -// clearForcePick=true → 清除强提风险标记(人工确认现场安全后)。 +// +// locked=true → 人工锁定(reason 必填,locked_by=manual,仅人工解锁); +// locked=false → 人工解锁(含 JBT21 手动解锁、系统锁人工释放); +// clearForcePick=true → 清除强提风险标记(人工确认现场安全后)。 +// // 全部操作 event_log 留痕。 func AgvPointLockHandler(svcCtx *svc.ServiceContext) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { diff --git a/bj_power_mes/internal/handler/production/agv_ws.go b/bj_power_mes/internal/handler/production/agv_ws.go new file mode 100644 index 0000000..a9364b7 --- /dev/null +++ b/bj_power_mes/internal/handler/production/agv_ws.go @@ -0,0 +1,44 @@ +package production + +import ( + "net/http" + "strings" + "sync" + "time" + + "bj_power_mes/common/httpx" + tokenx "bj_power_mes/common/token" + "bj_power_mes/internal/svc" + "bj_power_mes/internal/ws" +) + +var ( + agvHubOnce sync.Once + agvHub *ws.AgvHub +) + +func globalAgvHub(svcCtx *svc.ServiceContext) *ws.AgvHub { + agvHubOnce.Do(func() { + agvHub = ws.NewAgvHub(svcCtx) + }) + return agvHub +} + +// AgvWsHandler GET /api/v1/agv/ws?token= 人工派车状态推送。 +// 浏览器 WebSocket 无法带 Authorization 头,token 走 query;校验复用 tokenx.Parse(签名+过期), +// 通过后交由 AgvHub 升级管理。状态来源:AgvHub 定时拉海康 RCS 写回本地库后对比快照变化即推。 +func AgvWsHandler(svcCtx *svc.ServiceContext) http.HandlerFunc { + return func(w http.ResponseWriter, r *http.Request) { + tok := strings.TrimSpace(r.URL.Query().Get("token")) + if tok == "" { + httpx.Unauthorized(w, "缺少登录凭证,请重新登录") + return + } + claims, err := tokenx.Parse(svcCtx.Config.Auth.AccessSecret, tok) + if err != nil || claims == nil || claims.ExpiresAt == nil || time.Until(claims.ExpiresAt.Time) <= 0 { + httpx.Unauthorized(w, "登录凭证无效或已过期,请重新登录") + return + } + globalAgvHub(svcCtx).Handle(w, r) + } +} diff --git a/bj_power_mes/internal/handler/routes_production.go b/bj_power_mes/internal/handler/routes_production.go index 97879ac..d10fc38 100644 --- a/bj_power_mes/internal/handler/routes_production.go +++ b/bj_power_mes/internal/handler/routes_production.go @@ -449,6 +449,7 @@ func RegisterProductionRoutes(server *rest.Server, serverCtx *svc.ServiceContext // 手动多段链(2026-11-06 拍板):逐节点人工推进,全程锁同一台车 {Method: http.MethodPost, Path: "/agv/chain/next", Handler: production.AgvChainNextHandler(serverCtx)}, {Method: http.MethodPost, Path: "/agv/chain/end", Handler: production.AgvChainEndHandler(serverCtx)}, + {Method: http.MethodPost, Path: "/agv/chain/force-end", Handler: production.AgvChainForceEndHandler(serverCtx)}, {Method: http.MethodGet, Path: "/agv/chain/list", Handler: production.AgvChainListHandler(serverCtx)}, {Method: http.MethodGet, Path: "/agv/mode", Handler: production.AgvModeHandler(serverCtx)}, // AGV 点位管理(独立点位表:硬件映射编码/接驳台绑定不可改,仅名称/启用可改) @@ -652,6 +653,12 @@ func RegisterProductionRoutes(server *rest.Server, serverCtx *svc.ServiceContext Method: http.MethodGet, Path: "/api/v1/todos/ws", Handler: production.TodoWsHandler(serverCtx), }, rest.WithTimeout(3600_000_000_000)) + // ---------- 人工派车状态 WebSocket:长连接推送 AGV 到位/失败,免手动刷新 ---------- + // token 走 query 由 AgvWsHandler 自校验(同 TodoWs),不挂 WithJwt;放宽超时避免 5s 断连。 + server.AddRoute(rest.Route{ + Method: http.MethodGet, Path: "/api/v1/agv/ws", Handler: production.AgvWsHandler(serverCtx), + }, rest.WithTimeout(3600_000_000_000)) + // ---------- 海康 RCS-Lite SPI 主动回调(文档 2.2.1 任务执行通知 agvCallback) ---------- // 注意:RCS 回调不携带我方鉴权头;生产环境必须以防火墙 / IP 白名单隔离该端点(待与 RCS 方确认鉴权方式)。 // RCS-Lite 后台需将上层回调地址配置为本端点(路径遵循文档 /xxx/agv/agvCallbackService/agvCallback)。 diff --git a/bj_power_mes/internal/logic/agv.go b/bj_power_mes/internal/logic/agv.go index 6b4f7b7..001e872 100644 --- a/bj_power_mes/internal/logic/agv.go +++ b/bj_power_mes/internal/logic/agv.go @@ -55,7 +55,7 @@ type AgvPointView struct { LockedBy string `json:"lockedBy"` // system / manual LockedReason string `json:"lockedReason"` // 任务号或人工原因 LockedAt int64 `json:"lockedAt"` - ForcePick bool `json:"forcePick"` // 强提风险标记(派车需人工二次确认) + ForcePick bool `json:"forcePick"` // 强提风险标记(派车需人工二次确认) ForcePickAt int64 `json:"forcePickAt"` CreatedAt int64 `json:"createdAt"` } @@ -297,7 +297,7 @@ func (s *Service) agvRcsCommFail(ctx context.Context, where string, err error) { // DispatchAgvForCall 业务配送单派车(2026-11-13 拍板:独立「手动派车/叫料派车」入口下线, // 只由仓库备料完成等业务配送链路触发;前端不再有可直调的手动派车路由): // 由库管在 WMS 叫料队列点「送货」(DispatchCallAgv)调用——生成「空车前往装货点(JBT21)」段 -//(kind=GO_LOAD)并下发。AGV 到位后 status=ARRIVED(到位待令),库管点「确认装车并送货」 +// (kind=GO_LOAD)并下发。AGV 到位后 status=ARRIVED(到位待令),库管点「确认装车并送货」 // 才生成重载运输段(TRANSPORT)发往工位接驳台;卸货点再经「卸货完成并放行」后空车回充。 // 失败仅记日志/预警(best-effort),不阻断调用方响应。 func (s *Service) DispatchAgvForCall(ctx context.Context, mr *ent.MaterialRequest, operator string) error { @@ -680,7 +680,7 @@ func (s *Service) ApplyAgvCallback(ctx context.Context, taskCode, method, robotC // notifyDeliveredOnArrival AGV 到位 → 关联出库单回写「已送达」(2026-11-03 断头路补全: // 出库单状态机「已出库/已送达」此前无写者)。任务关联叫料单 → 叫料单上回写的 WMS 出库单号 -//(可多个逗号分隔)→ 通知 WMS 置已送达。best-effort:WMS 不可达只记日志,不阻断到位链路。 +// (可多个逗号分隔)→ 通知 WMS 置已送达。best-effort:WMS 不可达只记日志,不阻断到位链路。 func (s *Service) notifyDeliveredOnArrival(ctx context.Context, t *ent.AgvTask) { if t == nil || t.RelatedRequestNo == "" || s.ctx.Wms == nil { return @@ -721,8 +721,8 @@ func (s *Service) notifyDeliveredOnArrival(ctx context.Context, t *ent.AgvTask) // 确认装车(车背托盘离开装货点)→ 装货点 hasPallet=false;确认卸货(托盘上台)→ 卸货点 hasPallet=true。 const ( - dockStoreCode = "JBT21" // 库房接驳台(装货点/空托盘回收终点;T7 2026-11-03 统一 JBT21) - agvChargePoint = "AGV-CHARGE01" // 充电位(seed 纯点位,is_dock=false) + dockStoreCode = "JBT21" // 库房接驳台(装货点/空托盘回收终点;T7 2026-11-03 统一 JBT21) + agvChargePoint = "AGV-CHARGE01" // 充电位(seed 纯点位,is_dock=false) ) // agvSegInput 单段任务入参 @@ -742,9 +742,11 @@ type agvSegInput struct { } // agvTemplateType 模板推导唯一入口(2026-11-14 用户终版改为【按点位码硬编码】): -// 目标点为 JBT21 或 GW*(工位接驳台)→ LIFT → B01 举升任务模板; -// 目标点为 7 个虚拟点位(A1-A4 / XW / XT / KF1)→ NONE → B02 移动任务模板。 -// 历史 DOCK* 业务点位不在 28 个点位内,按库内 is_dock 兜底,保证存量派车链路不被改动。 +// +// 目标点为 JBT21 或 GW*(工位接驳台)→ LIFT → B01 举升任务模板; +// 目标点为 7 个虚拟点位(A1-A4 / XW / XT / KF1)→ NONE → B02 移动任务模板。 +// 历史 DOCK* 业务点位不在 28 个点位内,按库内 is_dock 兜底,保证存量派车链路不被改动。 +// // 规则真源 logic.AgvTemplateOf;举升模板编号仍取「基础设置」可配值(默认 B01/B02)。 // 原实现「起点或终点任一为接驳台就举升」已废止;模板内部动作序列由 RCS 预置,MES 不控制动作。 // 点位查询失败返回错误阻断下发(宁可不下发)。 @@ -816,7 +818,11 @@ func (s *Service) dispatchAgvSegment(ctx context.Context, in agvSegInput) (strin return "", err } submitTmpl := tmpl - if tmpl == "LIFT" { submitTmpl = s.CfgStr(ctx, CfgAgvTaskTypLift, "B01") } else { submitTmpl = s.CfgStr(ctx, CfgAgvTaskTypPlain, "B02") } + if tmpl == "LIFT" { + submitTmpl = s.CfgStr(ctx, CfgAgvTaskTypLift, "B01") + } else { + submitTmpl = s.CfgStr(ctx, CfgAgvTaskTypPlain, "B02") + } _, aerr := s.ctx.Agv.SubmitTask(ctx, taskNo, in.Source, in.Target, "", submitTmpl, in.AgvCode) if aerr != nil { s.agvRcsCommFail(ctx, "下发 "+in.Source+"→"+in.Target, aerr) @@ -971,9 +977,9 @@ func (s *Service) FinishFreeReturn(ctx context.Context, taskNo, operator string) // AgvChainInfo 手动链视图(任务进行中面板)。 type AgvChainInfo struct { ChainNo string `json:"chainNo"` - AgvCode string `json:"agvCode"` // 锁定车(最新回写的 agv_code;空=RCS 尚未分车) - Active bool `json:"active"` // 是否进行中(最新段未终态) - Segments []AgvTaskView `json:"segments"` // 已走节点(按段创建顺序) + AgvCode string `json:"agvCode"` // 锁定车(最新回写的 agv_code;空=RCS 尚未分车) + Active bool `json:"active"` // 是否进行中(最新段未终态) + Segments []AgvTaskView `json:"segments"` // 已走节点(按段创建顺序) } // agvChainSegments 取链内全部段(按创建顺序);不存在返回空。 @@ -1012,7 +1018,7 @@ func agvChainGuardManual(segs []*ent.AgvTask) error { } // AgvChainNextNode 手动链「下一个节点」:当前段必须已到位(ARRIVED);取链锁定车 -//(最新段 agv_code,未回写则拒绝)注入下发;当前段置 9,新段挂同一链号。 +// (最新段 agv_code,未回写则拒绝)注入下发;当前段置 9,新段挂同一链号。 // source 空=沿用上一节点落点;target 必填(用户自选下一段去哪)。 // confirmForcePick="1" 表示用户已对强提风险目标点位完成人工二次确认。 func (s *Service) AgvChainNextNode(ctx context.Context, chainNo, source, target, operator, confirmForcePick string) (string, error) { @@ -1072,7 +1078,7 @@ func (s *Service) AgvChainNextNode(ctx context.Context, chainNo, source, target, } // AgvChainEndTask 手动链「结束任务」:当前段必须已到位(ARRIVED);先校验 AGV 上无托盘 -//(载货台账硬校验 + RCS 实时车载货架校验),通过后当前段置 9,下发空车回充段(不指定车)。 +// (载货台账硬校验 + RCS 实时车载货架校验),通过后当前段置 9,下发空车回充段(不指定车)。 // force=人工确认无托盘强制结束:仅在 RCS 状态查询失败(超时/报错)时放行,操作留痕; // 台账判定有托盘时无论是否 force 一律拒绝(台账是系统权威,人工勾选不覆盖)。 func (s *Service) AgvChainEndTask(ctx context.Context, chainNo, operator string, force bool) error { @@ -1132,6 +1138,44 @@ func (s *Service) AgvChainEndTask(ctx context.Context, chainNo, operator string, return nil } +// AgvChainForceEnd 手动链「强制结束」安全阀(2026-11-16 主控定案): +// 用途=解开「AGV 未到位却无法结束、也无法继续」的系统死锁。当现场实物已人工处置 +// (货已卸/车已停),但 RCS 状态未回、回调丢失或断网导致本地段卡在 1/2/FAILED 时, +// 人工确认后调用。本方法【只清系统状态】:当前段置终态 9 + 释放目标点位系统锁 + 留痕; +// 【绝不调用海康任何接口】——尤其不调 cancelTask(forceCancel=0 会把车上的货直接扔在路上, +// 见《AGV海康litev1.5.md》§2.1.3)。下发空车回充也不做:现场车辆处置由人负责,系统不再遥控。 +// 风险由前端确认弹窗明确告知,后端这里只保证本地状态机一致、不产生任何物理动作。 +func (s *Service) AgvChainForceEnd(ctx context.Context, chainNo, operator, reason string) error { + if chainNo == "" { + return errors.New("缺少任务链号") + } + segs := s.agvChainSegments(ctx, chainNo) + if err := agvChainGuardManual(segs); err != nil { + return err + } + cur := agvChainCurrent(segs) + if cur == nil { + return errors.New("任务链已结束,无需强制结束") + } + oldStatus := cur.Status + oldDock := cur.TargetDock + oldTaskNo := cur.TaskNo + // 1) 仅本地:当前段置终态(9=完成,与正常结束同口径,让链从 agvChainCurrent 消失) + if err := s.ctx.EntClient.AgvTask.UpdateOneID(cur.ID).SetStatus("9").Exec(ctx); err != nil { + return err + } + // 2) 仅本地:释放该任务占用的点位系统锁(避免后续派车被幽灵锁挡住) + s.unlockAgvPointByTask(ctx, oldDock, oldTaskNo) + // 3) 留痕:明确标注「仅清系统状态、未通知 RCS、实物需人工已处置」 + if reason == "" { + reason = "未填写(受控入口应强制选择)" + } + s.ctx.EventLog.Write(ctx, "agv.chain_force_end", operator, "", "agv_task", chainNo, + "强制结束(仅解系统死锁,未通知RCS):段 "+oldTaskNo+" 状态 "+oldStatus+"→9,点位 "+oldDock+" 系统锁已释放;现场处置="+reason, + map[string]any{"taskNo": oldTaskNo, "oldStatus": oldStatus, "targetDock": oldDock, "reason": reason}) + return nil +} + // AgvChainList 手动链列表(任务进行中面板):全部 kind=MANUAL 段按链号分组, // AgvCode 取链内最新回写值,Active=链内存在非终态段。按链起始时间倒序。 func (s *Service) AgvChainList(ctx context.Context) ([]AgvChainInfo, error) { @@ -1142,7 +1186,7 @@ func (s *Service) AgvChainList(ctx context.Context) ([]AgvChainInfo, error) { if err != nil { return nil, err } - order := []string{} // 链号首次出现顺序(id 升序=创建顺序) + order := []string{} // 链号首次出现顺序(id 升序=创建顺序) byChain := map[string][]*ent.AgvTask{} for _, seg := range segs { cn := seg.ChainNo diff --git a/bj_power_mes/internal/netutil/localip.go b/bj_power_mes/internal/netutil/localip.go new file mode 100644 index 0000000..2d9f562 --- /dev/null +++ b/bj_power_mes/internal/netutil/localip.go @@ -0,0 +1,54 @@ +// Package netutil 提供本机 IP 缓存,供跨系统通信日志前缀使用(断网排查时能一眼看到是哪台机器发的日志)。 +package netutil + +import ( + "net" + "sync" +) + +var ( + once sync.Once + tagValue string +) + +// Tag 返回日志前缀片段,形如 [host=192.168.1.10];取不到非环回 IPv4 时返回 [host=?]。 +// 进程内只解析一次(sync.Once),不每次请求都枚举网卡;不使用正则,纯标准库。 +func Tag() string { + once.Do(func() { + ip := firstNonLoopbackIPv4() + if ip == "" { + ip = "?" + } + tagValue = "[host=" + ip + "]" + }) + return tagValue +} + +// LocalIP 返回缓存的本机非环回 IPv4(取不到返回空串)。 +func LocalIP() string { + Tag() + ip := tagValue + const p, s = "[host=", "]" + if len(ip) > len(p)+len(s) { + return ip[len(p) : len(ip)-len(s)] + } + return "" +} + +func firstNonLoopbackIPv4() string { + addrs, err := net.InterfaceAddrs() + if err != nil { + return "" + } + for _, a := range addrs { + ipnet, ok := a.(*net.IPNet) + if !ok || ipnet.IP.IsLoopback() { + continue + } + v4 := ipnet.IP.To4() + if v4 != nil { + return v4.String() + } + } + return "" +} diff --git a/bj_power_mes/internal/plc/logging.go b/bj_power_mes/internal/plc/logging.go index 2c5467d..f96a54b 100644 --- a/bj_power_mes/internal/plc/logging.go +++ b/bj_power_mes/internal/plc/logging.go @@ -8,21 +8,25 @@ import ( "context" "fmt" + "bj_power_mes/internal/netutil" "github.com/zeromicro/go-zero/core/logx" ) +// commTag 本机 IP 前缀(进程启动解析一次),断网排查时可一眼看出日志来自哪台机器。 +var commTag = netutil.Tag() + // logClient 日志装饰器:inner 为真实实现(s7Real / tcpClient / mock)。 type logClient struct{ inner Client } func newLogClient(inner Client) *logClient { return &logClient{inner: inner} } func (l *logClient) SendProcessCode(ctx context.Context, combination string) ([]int, error) { - logx.WithContext(ctx).Infof("[PLC] --> SendProcessCode combination=%s", combination) + logx.WithContext(ctx).Infof("[PLC]"+commTag+" --> SendProcessCode combination=%s", combination) codes, err := l.inner.SendProcessCode(ctx, combination) if err != nil { - logx.WithContext(ctx).Errorf("[PLC] <-- SendProcessCode err=%v", err) + logx.WithContext(ctx).Errorf("[PLC]"+commTag+" <-- SendProcessCode err=%v", err) } else { - logx.WithContext(ctx).Infof("[PLC] <-- SendProcessCode codes=%v", codes) + logx.WithContext(ctx).Infof("[PLC]"+commTag+" <-- SendProcessCode codes=%v", codes) } return codes, err } @@ -30,24 +34,24 @@ func (l *logClient) SendProcessCode(ctx context.Context, combination string) ([] func (l *logClient) QueryDone(ctx context.Context) (bool, error) { done, err := l.inner.QueryDone(ctx) if err != nil { - logx.WithContext(ctx).Errorf("[PLC] <-- QueryDone err=%v", err) + logx.WithContext(ctx).Errorf("[PLC]"+commTag+" <-- QueryDone err=%v", err) } else { - logx.WithContext(ctx).Infof("[PLC] <-- QueryDone done=%v", done) + logx.WithContext(ctx).Infof("[PLC]"+commTag+" <-- QueryDone done=%v", done) } return done, err } func (l *logClient) AckDone(ctx context.Context, ok bool) { - logx.WithContext(ctx).Infof("[PLC] AckDone ok=%v", ok) + logx.WithContext(ctx).Infof("[PLC]"+commTag+" AckDone ok=%v", ok) l.inner.AckDone(ctx, ok) } func (l *logClient) QueryDockPallet(ctx context.Context, dockCode string) (bool, error) { has, err := l.inner.QueryDockPallet(ctx, dockCode) if err != nil { - logx.WithContext(ctx).Errorf("[PLC] <-- QueryDockPallet dock=%s err=%v", dockCode, err) + logx.WithContext(ctx).Errorf("[PLC]"+commTag+" <-- QueryDockPallet dock=%s err=%v", dockCode, err) } else { - logx.WithContext(ctx).Infof("[PLC] <-- QueryDockPallet dock=%s hasPallet=%v", dockCode, has) + logx.WithContext(ctx).Infof("[PLC]"+commTag+" <-- QueryDockPallet dock=%s hasPallet=%v", dockCode, has) } return has, err } @@ -55,9 +59,9 @@ func (l *logClient) QueryDockPallet(ctx context.Context, dockCode string) (bool, func (l *logClient) QueryStationPallet(ctx context.Context, stationNo int) (bool, error) { has, err := l.inner.QueryStationPallet(ctx, stationNo) if err != nil { - logx.WithContext(ctx).Errorf("[PLC] <-- QueryStationPallet station=%d err=%v", stationNo, err) + logx.WithContext(ctx).Errorf("[PLC]"+commTag+" <-- QueryStationPallet station=%d err=%v", stationNo, err) } else { - logx.WithContext(ctx).Infof("[PLC] <-- QueryStationPallet station=%d hasPallet=%v", stationNo, has) + logx.WithContext(ctx).Infof("[PLC]"+commTag+" <-- QueryStationPallet station=%d hasPallet=%v", stationNo, has) } return has, err } @@ -65,7 +69,7 @@ func (l *logClient) QueryStationPallet(ctx context.Context, stationNo int) (bool func (l *logClient) ReadBits(ctx context.Context) ([]bool, error) { bits, err := l.inner.ReadBits(ctx) if err != nil { - logx.WithContext(ctx).Errorf("[PLC] <-- ReadBits err=%v", err) + logx.WithContext(ctx).Errorf("[PLC]"+commTag+" <-- ReadBits err=%v", err) } else { // 48 位压成 0/1 字符串,一行可读 s := make([]byte, len(bits)) @@ -76,7 +80,7 @@ func (l *logClient) ReadBits(ctx context.Context) ([]bool, error) { s[i] = '0' } } - logx.WithContext(ctx).Infof("[PLC] <-- ReadBits bits=%s", string(s)) + logx.WithContext(ctx).Infof("[PLC]"+commTag+" <-- ReadBits bits=%s", string(s)) } return bits, err } @@ -84,9 +88,9 @@ func (l *logClient) ReadBits(ctx context.Context) ([]bool, error) { func (l *logClient) ReadMW(ctx context.Context, addr int) (int, error) { v, err := l.inner.ReadMW(ctx, addr) if err != nil { - logx.WithContext(ctx).Errorf("[PLC] <-- ReadMW MW%d err=%v", addr, err) + logx.WithContext(ctx).Errorf("[PLC]"+commTag+" <-- ReadMW MW%d err=%v", addr, err) } else { - logx.WithContext(ctx).Infof("[PLC] <-- ReadMW MW%d=%d", addr, v) + logx.WithContext(ctx).Infof("[PLC]"+commTag+" <-- ReadMW MW%d=%d", addr, v) } return v, err } @@ -94,18 +98,18 @@ func (l *logClient) ReadMW(ctx context.Context, addr int) (int, error) { func (l *logClient) ReadMWBlock(ctx context.Context, start, count int) ([]int, error) { vals, err := l.inner.ReadMWBlock(ctx, start, count) if err != nil { - logx.WithContext(ctx).Errorf("[PLC] <-- ReadMWBlock MW%d..MW%d err=%v", start, start+count-1, err) + logx.WithContext(ctx).Errorf("[PLC]"+commTag+" <-- ReadMWBlock MW%d..MW%d err=%v", start, start+count-1, err) } else { - logx.WithContext(ctx).Infof("[PLC] <-- ReadMWBlock MW%d..MW%d vals=%v", start, start+count-1, vals) + logx.WithContext(ctx).Infof("[PLC]"+commTag+" <-- ReadMWBlock MW%d..MW%d vals=%v", start, start+count-1, vals) } return vals, err } func (l *logClient) WriteMW(ctx context.Context, addr, value int) error { - logx.WithContext(ctx).Infof("[PLC] --> WriteMW MW%d=%d", addr, value) + logx.WithContext(ctx).Infof("[PLC]"+commTag+" --> WriteMW MW%d=%d", addr, value) err := l.inner.WriteMW(ctx, addr, value) if err != nil { - logx.WithContext(ctx).Errorf("[PLC] <-- WriteMW MW%d=%d err=%v", addr, value, err) + logx.WithContext(ctx).Errorf("[PLC]"+commTag+" <-- WriteMW MW%d=%d err=%v", addr, value, err) } return err } diff --git a/bj_power_mes/internal/wmsclient/transport_logging.go b/bj_power_mes/internal/wmsclient/transport_logging.go index c48bbcf..acf438b 100644 --- a/bj_power_mes/internal/wmsclient/transport_logging.go +++ b/bj_power_mes/internal/wmsclient/transport_logging.go @@ -11,9 +11,13 @@ import ( "io" "net/http" + "bj_power_mes/internal/netutil" "github.com/zeromicro/go-zero/core/logx" ) +// commTag 本机 IP 前缀(进程启动解析一次),断网排查时可一眼看出日志来自哪台机器。 +var commTag = netutil.Tag() + // loggingTransport 日志装饰 transport。 type loggingTransport struct{ base http.RoundTripper } @@ -34,11 +38,11 @@ func (t *loggingTransport) RoundTrip(req *http.Request) (*http.Response, error) _ = req.Body.Close() req.Body = io.NopCloser(bytes.NewReader(reqBody)) } - logx.WithContext(req.Context()).Infof("[MES→WMS] --> %s %s body=%s", req.Method, u, truncateLogBytes(reqBody)) + logx.WithContext(req.Context()).Infof("[MES→WMS]"+commTag+"--> %s %s body=%s", req.Method, u, truncateLogBytes(reqBody)) resp, err := t.base.RoundTrip(req) if err != nil { - logx.WithContext(req.Context()).Errorf("[MES→WMS] <-- transport error %s err=%v", u, err) + logx.WithContext(req.Context()).Errorf("[MES→WMS]"+commTag+"<-- transport error %s err=%v", u, err) if FailHook != nil { FailHook(req.Context(), req.Method, u, err) } @@ -47,10 +51,10 @@ func (t *loggingTransport) RoundTrip(req *http.Request) (*http.Response, error) raw, rerr := io.ReadAll(resp.Body) _ = resp.Body.Close() if rerr != nil { - logx.WithContext(req.Context()).Errorf("[MES→WMS] <-- read body error %s status=%d err=%v", u, resp.StatusCode, rerr) + logx.WithContext(req.Context()).Errorf("[MES→WMS]"+commTag+"<-- read body error %s status=%d err=%v", u, resp.StatusCode, rerr) } resp.Body = io.NopCloser(bytes.NewReader(raw)) - logx.WithContext(req.Context()).Infof("[MES→WMS] <-- HTTP %d %s body=%s", resp.StatusCode, u, truncateLogBytes(raw)) + logx.WithContext(req.Context()).Infof("[MES→WMS]"+commTag+"<-- HTTP %d %s body=%s", resp.StatusCode, u, truncateLogBytes(raw)) return resp, nil } diff --git a/bj_power_mes/internal/ws/agv_hub.go b/bj_power_mes/internal/ws/agv_hub.go new file mode 100644 index 0000000..c9005ca --- /dev/null +++ b/bj_power_mes/internal/ws/agv_hub.go @@ -0,0 +1,178 @@ +package ws + +import ( + "context" + "encoding/json" + "net/http" + "sync" + "time" + + "bj_power_mes/internal/logic" + "bj_power_mes/internal/svc" + + "github.com/gorilla/websocket" + "github.com/zeromicro/go-zero/core/logx" +) + +// AGV 人工派车状态推送参数:轮询间隔 / 写读超时 / ping 间隔。 +const ( + agvPollInterval = 3 * time.Second // AGV 状态要求秒级感知,3s 拉一次 RCS + agvWriteTimeout = 5 * time.Second + agvReadTimeout = 90 * time.Second + agvPingInterval = 30 * time.Second +) + +// agvClient 单个 WebSocket 连接;send 由 writePump 独占写,避免并发写冲突。 +type agvClient struct { + conn *websocket.Conn + send chan []byte +} + +// AgvHub 人工派车 WebSocket 推送中心: +// - 首个连接建立时懒启动轮询:每 agvPollInterval 先 RefreshAgvTasks(拉海康 RCS → 写回本地库), +// 再取手动链快照 AgvChainList,与上次不一致才广播 —— 兼顾「断网恢复后自动同步」与「状态变化秒级推送」。 +// - RCS 回调(ApplyAgvCallback)改库后也调 BroadcastNow 主动推一帧,不等下一个轮询周期。 +type AgvHub struct { + svcCtx *svc.ServiceContext + upgrader websocket.Upgrader + mu sync.Mutex + clients map[*agvClient]struct{} + last string + once sync.Once +} + +func NewAgvHub(svcCtx *svc.ServiceContext) *AgvHub { + h := &AgvHub{ + svcCtx: svcCtx, + clients: map[*agvClient]struct{}{}, + } + h.upgrader = websocket.Upgrader{CheckOrigin: sameOrigin} + return h +} + +func (h *AgvHub) add(c *agvClient) { + h.mu.Lock() + h.clients[c] = struct{}{} + h.mu.Unlock() +} + +func (h *AgvHub) remove(c *agvClient) { + h.mu.Lock() + delete(h.clients, c) + h.mu.Unlock() + _ = c.conn.Close() +} + +// snapshot 取一次手动链快照(仅 MANUAL 段,即人工派车页面消费的数据)。 +func (h *AgvHub) snapshot(ctx context.Context) []byte { + list, err := logic.New(h.svcCtx).AgvChainList(ctx) + if err != nil { + logx.Errorf("AGV 链快照失败:%v", err) + list = []logic.AgvChainInfo{} + } + b, _ := json.Marshal(map[string]any{"chains": list}) + return b +} + +// publishIfChanged 先拉 RCS 更新本地库,再取快照对比,变化才广播。 +func (h *AgvHub) publishIfChanged(ctx context.Context) { + if _, err := logic.New(h.svcCtx).RefreshAgvTasks(ctx); err != nil { + logx.Errorf("AGV RCS 状态刷新失败:%v", err) + } + h.BroadcastNow(ctx) +} + +// BroadcastNow 立即取快照并在变化时广播(RCS 回调改库后调用,秒级推送)。 +func (h *AgvHub) BroadcastNow(ctx context.Context) { + payload := h.snapshot(ctx) + h.mu.Lock() + if string(payload) == h.last { + h.mu.Unlock() + return + } + h.last = string(payload) + h.mu.Unlock() + h.broadcast(payload) +} + +func (h *AgvHub) broadcast(payload []byte) { + h.mu.Lock() + for c := range h.clients { + select { + case c.send <- payload: + default: // 慢客户端丢弃当前帧,不阻塞其它连接(下一个周期会推最新全量) + } + } + h.mu.Unlock() +} + +// startPolling 首个连接建立时懒启动轮询。 +func (h *AgvHub) startPolling() { + h.once.Do(func() { + go func() { + ticker := time.NewTicker(agvPollInterval) + defer ticker.Stop() + for range ticker.C { + h.publishIfChanged(context.Background()) + } + }() + }) +} + +// Handle 升级为 WebSocket:先推一次全量并对齐 last,再由 writePump 串行写广播帧与 ping。 +// token 校验在 handler 层完成。 +func (h *AgvHub) Handle(w http.ResponseWriter, r *http.Request) { + conn, err := h.upgrader.Upgrade(w, r, nil) + if err != nil { + logx.Errorf("AGV WebSocket 升级失败:%v", err) + return + } + c := &agvClient{conn: conn, send: make(chan []byte, 16)} + h.add(c) + h.startPolling() + + payload := h.snapshot(r.Context()) + h.mu.Lock() + h.last = string(payload) + h.mu.Unlock() + c.send <- payload + + go h.writePump(c) + h.readPump(c) +} + +func (h *AgvHub) readPump(c *agvClient) { + defer h.remove(c) + c.conn.SetReadLimit(1024) + _ = c.conn.SetReadDeadline(time.Now().Add(agvReadTimeout)) + c.conn.SetPongHandler(func(string) error { + return c.conn.SetReadDeadline(time.Now().Add(agvReadTimeout)) + }) + for { + if _, _, err := c.conn.ReadMessage(); err != nil { + return + } + } +} + +func (h *AgvHub) writePump(c *agvClient) { + ticker := time.NewTicker(agvPingInterval) + defer func() { + ticker.Stop() + _ = c.conn.Close() + }() + for { + select { + case msg := <-c.send: + _ = c.conn.SetWriteDeadline(time.Now().Add(agvWriteTimeout)) + if err := c.conn.WriteMessage(websocket.TextMessage, msg); err != nil { + return + } + case <-ticker.C: + _ = c.conn.SetWriteDeadline(time.Now().Add(agvWriteTimeout)) + if err := c.conn.WriteMessage(websocket.PingMessage, nil); err != nil { + return + } + } + } +} diff --git a/bj_power_mes/public/index.html b/bj_power_mes/public/index.html index 4c0ba30..02ca4ca 100644 --- a/bj_power_mes/public/index.html +++ b/bj_power_mes/public/index.html @@ -6,7 +6,7 @@ MES 产线控制 - + diff --git a/bj_power_wms/internal/mesclient/transport_logging.go b/bj_power_wms/internal/mesclient/transport_logging.go index 9ac4d47..6bc0001 100644 --- a/bj_power_wms/internal/mesclient/transport_logging.go +++ b/bj_power_wms/internal/mesclient/transport_logging.go @@ -12,9 +12,13 @@ import ( "io" "net/http" + "bj_power_wms/internal/netutil" "github.com/zeromicro/go-zero/core/logx" ) +// commTag 本机 IP 前缀(进程启动解析一次),断网排查时可一眼看出日志来自哪台机器。 +var commTag = netutil.Tag() + // loggingTransport 日志装饰 transport。 type loggingTransport struct{ base http.RoundTripper } @@ -35,11 +39,11 @@ func (t *loggingTransport) RoundTrip(req *http.Request) (*http.Response, error) _ = req.Body.Close() req.Body = io.NopCloser(bytes.NewReader(reqBody)) } - logx.WithContext(req.Context()).Infof("[WMS→MES] --> %s %s body=%s", req.Method, u, truncateLogBytes(reqBody)) + logx.WithContext(req.Context()).Infof("[WMS→MES]"+commTag+" --> %s %s body=%s", req.Method, u, truncateLogBytes(reqBody)) resp, err := t.base.RoundTrip(req) if err != nil { - logx.WithContext(req.Context()).Errorf("[WMS→MES] <-- transport error %s err=%v", u, err) + logx.WithContext(req.Context()).Errorf("[WMS→MES]"+commTag+" <-- transport error %s err=%v", u, err) if FailHook != nil { FailHook(req.Context(), req.Method, u, err) } @@ -48,10 +52,10 @@ func (t *loggingTransport) RoundTrip(req *http.Request) (*http.Response, error) raw, rerr := io.ReadAll(resp.Body) _ = resp.Body.Close() if rerr != nil { - logx.WithContext(req.Context()).Errorf("[WMS→MES] <-- read body error %s status=%d err=%v", u, resp.StatusCode, rerr) + logx.WithContext(req.Context()).Errorf("[WMS→MES]"+commTag+" <-- read body error %s status=%d err=%v", u, resp.StatusCode, rerr) } resp.Body = io.NopCloser(bytes.NewReader(raw)) - logx.WithContext(req.Context()).Infof("[WMS→MES] <-- HTTP %d %s body=%s", resp.StatusCode, u, truncateLogBytes(raw)) + logx.WithContext(req.Context()).Infof("[WMS→MES]"+commTag+" <-- HTTP %d %s body=%s", resp.StatusCode, u, truncateLogBytes(raw)) return resp, nil } diff --git a/bj_power_wms/internal/netutil/localip.go b/bj_power_wms/internal/netutil/localip.go new file mode 100644 index 0000000..2d9f562 --- /dev/null +++ b/bj_power_wms/internal/netutil/localip.go @@ -0,0 +1,54 @@ +// Package netutil 提供本机 IP 缓存,供跨系统通信日志前缀使用(断网排查时能一眼看到是哪台机器发的日志)。 +package netutil + +import ( + "net" + "sync" +) + +var ( + once sync.Once + tagValue string +) + +// Tag 返回日志前缀片段,形如 [host=192.168.1.10];取不到非环回 IPv4 时返回 [host=?]。 +// 进程内只解析一次(sync.Once),不每次请求都枚举网卡;不使用正则,纯标准库。 +func Tag() string { + once.Do(func() { + ip := firstNonLoopbackIPv4() + if ip == "" { + ip = "?" + } + tagValue = "[host=" + ip + "]" + }) + return tagValue +} + +// LocalIP 返回缓存的本机非环回 IPv4(取不到返回空串)。 +func LocalIP() string { + Tag() + ip := tagValue + const p, s = "[host=", "]" + if len(ip) > len(p)+len(s) { + return ip[len(p) : len(ip)-len(s)] + } + return "" +} + +func firstNonLoopbackIPv4() string { + addrs, err := net.InterfaceAddrs() + if err != nil { + return "" + } + for _, a := range addrs { + ipnet, ok := a.(*net.IPNet) + if !ok || ipnet.IP.IsLoopback() { + continue + } + v4 := ipnet.IP.To4() + if v4 != nil { + return v4.String() + } + } + return "" +} diff --git a/bj_power_workstation/internal/mes/client.go b/bj_power_workstation/internal/mes/client.go index 6372079..9091a90 100644 --- a/bj_power_workstation/internal/mes/client.go +++ b/bj_power_workstation/internal/mes/client.go @@ -14,9 +14,13 @@ import ( "github.com/zeromicro/go-zero/core/logx" + "bj_power_workstation/internal/netutil" "bj_power_workstation/internal/tightening" ) +// commTag 本机 IP 前缀(进程启动解析一次),断网排查时可一眼看出日志来自哪台终端机。 +var commTag = netutil.Tag() + // ErrAuth 认证失效(401 / 登录态过期):可恢复错误。 // 调用方据此提示重新登录(2026-11-05 拍板:断网/认证失败直接报错,无离线重试)。 var ErrAuth = errors.New("station auth expired or invalid") @@ -128,16 +132,16 @@ func (c *Client) GetStream(path string, query url.Values) (io.ReadCloser, error) req.Header.Set("Accept", "text/event-stream") resp, err := c.streamClient.Do(req) if err != nil { - logx.Errorf("[终端→MES] <-- SSE connect error %s err=%v", u, err) + logx.Errorf("[终端→MES]"+commTag+" <-- SSE connect error %s err=%v", u, err) return nil, err } if resp.StatusCode != http.StatusOK { body, _ := io.ReadAll(resp.Body) resp.Body.Close() - logx.Errorf("[终端→MES] <-- SSE HTTP %d %s body=%s", resp.StatusCode, u, truncate(string(body), 200)) + logx.Errorf("[终端→MES]"+commTag+" <-- SSE HTTP %d %s body=%s", resp.StatusCode, u, truncate(string(body), 200)) return nil, fmt.Errorf("MES %s 返回 %d:%s", path, resp.StatusCode, truncate(string(body), 200)) } - logx.Infof("[终端→MES] <-- SSE connected %s", u) + logx.Infof("[终端→MES]"+commTag+" <-- SSE connected %s", u) return resp.Body, nil } @@ -164,12 +168,12 @@ func (c *Client) do(method, u string, body io.Reader, bearer string) ([]byte, ht reqBodyForLog, _ = io.ReadAll(body) req.Body = io.NopCloser(bytes.NewReader(reqBodyForLog)) } - logx.Infof("[终端→MES] --> %s %s body=%s", method, u, truncate(string(reqBodyForLog), 1000)) + logx.Infof("[终端→MES]"+commTag+" --> %s %s body=%s", method, u, truncate(string(reqBodyForLog), 1000)) resp, err := c.httpClient.Do(req) if err != nil { // 2026-11-16 联调:终端→MES 全量交互落日志(传输错误单独记录,grep "[终端→MES]") - logx.WithContext(req.Context()).Errorf("[终端→MES] <-- transport error %s %s err=%v", method, u, err) + logx.WithContext(req.Context()).Errorf("[终端→MES]"+commTag+" <-- transport error %s %s err=%v", method, u, err) return nil, nil, err } defer resp.Body.Close() @@ -179,7 +183,7 @@ func (c *Client) do(method, u string, body io.Reader, bearer string) ([]byte, ht return nil, resp.Header, err } // 请求/响应全量日志(请求体在下面 marshal 后记录;这里记录响应) - logx.WithContext(req.Context()).Infof("[终端→MES] <-- HTTP %d %s body=%s", resp.StatusCode, u, truncate(string(respBody), 1000)) + logx.WithContext(req.Context()).Infof("[终端→MES]"+commTag+" <-- HTTP %d %s body=%s", resp.StatusCode, u, truncate(string(respBody), 1000)) if resp.StatusCode == http.StatusUnauthorized { // 401 = 工位登录态过期/无效:调用方据此提示重新登录。 return respBody, resp.Header, fmt.Errorf("MES %s %s: %w", method, u, ErrAuth) diff --git a/bj_power_workstation/internal/netutil/localip.go b/bj_power_workstation/internal/netutil/localip.go new file mode 100644 index 0000000..2d9f562 --- /dev/null +++ b/bj_power_workstation/internal/netutil/localip.go @@ -0,0 +1,54 @@ +// Package netutil 提供本机 IP 缓存,供跨系统通信日志前缀使用(断网排查时能一眼看到是哪台机器发的日志)。 +package netutil + +import ( + "net" + "sync" +) + +var ( + once sync.Once + tagValue string +) + +// Tag 返回日志前缀片段,形如 [host=192.168.1.10];取不到非环回 IPv4 时返回 [host=?]。 +// 进程内只解析一次(sync.Once),不每次请求都枚举网卡;不使用正则,纯标准库。 +func Tag() string { + once.Do(func() { + ip := firstNonLoopbackIPv4() + if ip == "" { + ip = "?" + } + tagValue = "[host=" + ip + "]" + }) + return tagValue +} + +// LocalIP 返回缓存的本机非环回 IPv4(取不到返回空串)。 +func LocalIP() string { + Tag() + ip := tagValue + const p, s = "[host=", "]" + if len(ip) > len(p)+len(s) { + return ip[len(p) : len(ip)-len(s)] + } + return "" +} + +func firstNonLoopbackIPv4() string { + addrs, err := net.InterfaceAddrs() + if err != nil { + return "" + } + for _, a := range addrs { + ipnet, ok := a.(*net.IPNet) + if !ok || ipnet.IP.IsLoopback() { + continue + } + v4 := ipnet.IP.To4() + if v4 != nil { + return v4.String() + } + } + return "" +}