ZKTeco设备新增用户查询异常及Push SDK权限咨询

一、用户添加后查询结果不一致的排查方案 #

• 执行数据持久化操作：多数ZKTeco设备调用SSR_SetUserInfo()添加用户后，需调用SSR_SaveData(0)（参数0对应用户信息模块）将内存数据写入设备Flash存储。若跳过此步骤，SSR_GetAllUserInfo()读取的是存储中的旧数据，而SSR_GetUserInfo()直接查询内存临时数据，会导致结果不一致。
• 检查SSR_GetAllUserInfo()调用参数：确认传入参数正确，比如是否指定了正确的用户类型（如管理员/普通用户）、是否处理分页逻辑（部分设备需循环调用该方法，通过起始索引和数量参数获取全量用户，而非一次返回所有数据）。
• 刷新设备数据缓存：调用SSR_RefreshData(1)（常量USER_INFO通常值为1）强制刷新设备用户信息缓存，之后再执行SSR_GetAllUserInfo()查询。
• 验证设备与SDK版本兼容性：不同型号ZKTeco设备（如F2、X6系列）对SDK方法的支持存在差异，确认使用的Zkemclient版本与设备型号匹配，避免版本不兼容导致的异常。
• 断开重连后重试：部分设备修改数据后，当前连接的缓存未更新，可断开设备连接后重新建立，再执行查询操作。

二、SDK推送操作权限说明 #

ZKTeco官方提供的Zkemclient SDK允许通过合规接口进行数据推送操作，比如添加/修改用户信息、下发指纹模板、推送考勤规则等，这些都属于设备管理的正常功能，只要使用官方规范接口且符合设备使用协议，就是被允许的。需注意禁止使用非官方接口或进行未授权操作，避免损坏设备或违反相关协议。

内容的提问来源于stack exchange，提问作者Hivuong