Node.js ZKlib getRealTimeLogs函数无返回结果求助

1. 先确保设备连接成功再监听日志 #

很多时候问题出在未确认连接状态就调用监听方法，必须先通过connect()建立有效连接，再注册实时监听：

const ZKLib = require('node-zklib');
const zkInstance = new ZKLib('你的设备IP', 4370, 10000); // 默认端口4370，超时10秒

zkInstance.connect()
  .then(() => {
    console.log('设备连接成功');
    // 连接成功后启动实时日志监听
    zkInstance.getRealTimeLogs((data) => {
      console.log('实时打卡数据:', data);
    });
  })
  .catch(err => {
    console.error('设备连接失败:', err);
  });

• 检查设备IP、端口是否正确，确认设备与服务器在同一局域网，无防火墙/路由拦截端口。

2. 确认设备开启实时推送功能 #

部分考勤设备需要手动开启实时数据推送：

• 进入设备管理员设置界面，找到「实时上传」「主动推送日志」类选项并启用。
• 调用zkInstance.getDeviceInfo()获取设备型号和固件版本，旧型号可能不支持实时推送，只能用轮询方案。

3. 改用事件监听模式 #

部分node-zklib版本需要通过attendance事件接收实时数据，而非getRealTimeLogs回调：

zkInstance.connect().then(() => {
  zkInstance.enableRealTime(); // 先启用实时模式
  zkInstance.on('attendance', (data) => {
    console.log('实时打卡记录:', data);
  });
  // 监听错误排查问题
  zkInstance.on('error', (err) => {
    console.error('实时监听异常:', err);
  });
});

4. 排查库版本兼容性 #

尝试切换node-zklib版本，避免版本bug或兼容性问题：

# 安装最新稳定版
npm install node-zklib@latest
# 或指定已知兼容版本
npm install node-zklib@0.1.10

5. 轮询方案作为替代 #

如果实时推送始终无效，可采用定时轮询获取新日志：

let lastLogId = 0;
// 每5秒轮询一次
setInterval(async () => {
  try {
    const allLogs = await zkInstance.getAttendance();
    const newLogs = allLogs.filter(log => log.id > lastLogId);
    if (newLogs.length > 0) {
      console.log('新打卡记录:', newLogs);
      lastLogId = newLogs[newLogs.length - 1].id;
    }
  } catch (err) {
    console.error('轮询获取日志失败:', err);
  }
}, 5000);

内容的提问来源于stack exchange，提问作者Nhất