如何解决ZKTeco SDK中的"-307"连接错误？

1. -307错误的具体原因 #

-307错误在ZK门禁设备SDK场景中，核心是应用层连接被设备主动拒绝，常见触发场景包括：

• 端口不匹配：设备通讯端口（默认4370）被修改，但代码或演示程序仍用默认端口发起连接；
• IP白名单限制：设备开启了IP访问白名单，你的客户端IP不在允许范围内；
• 版本/协议不兼容：zkemkeeper.dll版本与设备固件版本不匹配，导致通讯协议协商失败；
• 通讯模式冲突：设备被设为UDP模式，但你用TCP方式连接（反之亦然）。

2. 错误码定义的查询渠道 #

• 官方SDK文档：获取zkemkeeper.dll的压缩包中，通常附带《ZK SDK开发手册》类文档，里面有完整的错误码对照表，包含每个错误码的含义、触发场景和排查建议；
• DLL接口枚举：通过Visual Studio添加zkemkeeper.dll引用后，自动生成的interop.zkemkeeper.dll中会包含错误码的枚举定义，可直接查看类库结构获取对应注释；也可用反编译工具（如dnSpy）打开原始dll，查看内置的错误码枚举及说明。

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