适用场景

门禁对接的难点在"双方数据模型不一致"：门禁按卡号，系统按人员，访客按凭证有效期。对接方案要把这三层映射讲清楚。

配置步骤（对接故障排查）

# 1) 网络层：ping 设备、确认端口开放（telnet 端口）
# 2) 应用层：看对接日志（请求/响应报文）
# 3) 数据层：核对人员/卡号是否真的下发到控制器（控制器页面或 SDK 查询）
# 4) 设备层：直接手动触发开门，排除硬件问题

关键参数与建议

  • 先统一凭证模型：卡号/二维码/人脸 ID 三选一为主，其余作为补充
  • 权限下发要有确认机制（下发成功/失败回执），否则会出现"系统显示已授权但门不开"
  • 记录回传必须带时间戳与出入口标识，便于追溯
  • 门禁控制器与平台之间要留时间同步，否则记录时序错乱
  • 断电与消防联动策略必须与甲方确认（断电开还是断电闭）

容易踩的坑

  • 只看平台日志不看控制器状态，误判为对接成功
  • 时间不同步导致记录时序错乱，排查方向跑偏
  • 网络抖动导致下发超时，但平台未重试

验证与巡检

# 每次排障保存：请求报文、响应报文、控制器侧记录
  • 巡检：对接日志留存、失败重试机制存在、时间同步正常

小结

对接验收三条：授权后能开、撤销后不能开、记录能查且时间正确。这三条过了，剩下的都是优化。

> 说明：文中命令为通用写法，不同型号/版本可能略有差异，落地前请对照设备实际版本的官方文档；带外管理与安全设备变更建议先在测试设备验证。