海康VM界面日志无法实时刷新或显示空白，如何排查？

Question

海康VM界面日志无法实时刷新或显示空白，常见原因包括：1）浏览器缓存或兼容性问题（建议使用Chrome最新版并禁用缓存）；2）VM服务端日志采集模块异常（检查`LogService`进程是否运行、日志路径权限及磁盘空间）；3）WebSocket连接中断（F12查看Network中`/ws/log`连接状态，确认Nginx/防火墙未拦截WS协议）；4）数据库日志表写入失败（核查`vm_log`表是否可写、MySQL binlog格式是否为ROW）；5）客户端时间与服务器偏差＞5分钟导致JWT鉴权失败，阻断日志推送。快速排查顺序：先刷新F12控制台报错→查VM管理端「系统监控」→验证`http://ip:8080/vms/api/log/latest`接口返回→最后检查`/opt/hikvision/vm/logs/vm-logservice.log`中的ERROR堆栈。多数案例由日志服务未启动或时钟不同步引发。

Answer 1

```html

一、表象层：前端界面异常（客户端视角）

日志区域持续空白或“加载中”状态不退出，F12控制台高频报 WebSocket connection to 'wss://xxx/ws/log' failed 或 Failed to load resource: net::ERR_CONNECTION_REFUSED。此时应优先排除浏览器环境干扰——禁用所有扩展、启用 Chrome 无痕模式、强制清除缓存（Ctrl+Shift+R），并验证是否仅在 IE/Edge 旧版复现。兼容性矩阵显示：VM 4.3+ 仅正式支持 Chromium 内核（Chrome ≥110 / Edge ≥110），Firefox 需手动启用 dom.websockets.enabled 并关闭 strict transport security（HSTS）策略。

二、协议层：实时通道阻断（WebSocket 健康度诊断）

打开开发者工具 → Network → Filter 输入 ws → 刷新页面观察 /ws/log 连接状态。若显示 Failed 或 Pending，需分三路排查：

• Nginx 配置缺失 WebSocket 升级头：proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";
• 防火墙策略误拦 8080 端口的 ws:// 和 wss:// 流量（注意：WS 不走 HTTP 代理，需放行 TCP 层）
• VM 负载均衡器未开启长连接透传（如 F5 iRule 中遗漏 websocket 关键字匹配）

三、服务层：LogService 进程与资源基线校验

执行以下命令链快速定位：

systemctl status vm-logservice
df -h /opt/hikvision/vm/logs
ls -ld /opt/hikvision/vm/logs
journalctl -u vm-logservice -n 50 --no-pager

典型异常信号：Active: inactive (dead)（服务未启动）、Permission denied（SELinux 强制模式下 context 错误）、No space left on device（磁盘 inode 耗尽而非容量满）。特别注意：VM 日志服务默认每 5 秒轮询一次磁盘可用空间，低于 5% 将自动降级为内存缓冲模式，导致 Web 界面延迟超 30s。

四、数据层：MySQL 日志持久化失效根因分析

执行 SQL 校验关键约束：

检查项	验证命令	合格标准
vm_log 表写权限	SHOW GRANTS FOR 'vm_user'@'%';	包含 INSERT, UPDATE ON vm_db.vm_log
binlog 格式	SELECT @@binlog_format;	必须为 ROW（VM 依赖 ROW 模式捕获变更触发日志推送）

五、安全层：JWT 鉴权时钟漂移（高隐蔽性故障）

当客户端系统时间比 NTP 服务器快/慢 >300 秒时，VM 后端签发的 JWT token 因 exp 和 nbf 时间戳校验失败，直接拒绝 WebSocket 握手请求。验证方式：

1. 客户端执行：timedatectl status | grep "System clock"
2. 服务端执行：ntpdate -q pool.ntp.org（误差值 >5s 即告警）
3. 修复方案：启用 systemd-timesyncd 或部署 chrony 集群同步，禁止手动 date -s 修改

六、全链路诊断流程图（Mermaid）

graph TD
  A[日志界面空白] --> B{F12 Console 报错?}
  B -->|Yes| C[记录 Error 类型]
  B -->|No| D[检查 Network ws/log 状态]
  C --> E[区分 CORS/WS/401 错误]
  D --> F{Connection established?}
  F -->|No| G[Nginx/防火墙/SSL证书]
  F -->|Yes| H[调用 /vms/api/log/latest 接口]
  H --> I{HTTP 200 + JSON 数据?}
  I -->|No| J[查 vm-logservice.log ERROR 堆栈]
  I -->|Yes| K[核查 MySQL vm_log 表写入延迟]
  J --> L[重点检查 LogService 进程 & 磁盘空间]
  K --> M[确认 binlog_format=ROW & 权限]

七、生产环境黄金检查清单（CLI 一键脚本片段）

将以下逻辑封装为 vm-log-troubleshoot.sh 可提升 80% 故障定位效率：

echo "== 1. WebSocket 连通性 =="; curl -I http://localhost:8080/ws/log 2>/dev/null | head -1
echo "== 2. LogService 状态 =="; systemctl is-active vm-logservice
echo "== 3. 磁盘余量 =="; df /opt/hikvision/vm/logs | awk 'NR==2 {print $5}'
echo "== 4. MySQL 日志表 =="; mysql -u vm_user -p'xxx' -e "SELECT COUNT(*) FROM vm_db.vm_log LIMIT 1;" 2>/dev/null || echo "ERROR"
echo "== 5. 时钟偏差 =="; ntpdate -q 192.168.1.1 | awk '{print $NF}' | sed 's/.$//'

八、架构级规避建议（面向 5 年以上从业者）

在 VM 高可用部署中，建议解耦日志服务：将 LogService 容器独立部署于专用节点，通过 Kafka 替代原生 WebSocket 推送，前端改用 Server-Sent Events（SSE）消费日志流。此举可规避 Nginx WebSocket 连接数瓶颈（默认 1024）、解决 TLS 1.3 下 WS 握手失败率上升问题，并天然支持跨地域日志聚合。海康官方 SDK v5.2 已开放 LogProducer 接口，支持自定义消息序列化协议。

```