常见问题

安装相关

安装插件后在 n8n 中找不到 TTLock 节点？

安装社区节点后需要重启 n8n 才能生效。如果重启后仍然找不到：

1. 确认安装的包名是 n8n-nodes-ttlock
2. 检查 n8n 版本是否 >= 1.0.0（可在 n8n 设置页面查看）
3. 查看 n8n 启动日志，确认没有加载错误

n8n 界面安装社区节点时提示失败？

尝试使用命令行方式安装：

npm install n8n-nodes-ttlock

安装完成后重启 n8n。

凭证相关

提示认证失败或 token 获取失败？

1. 确认 Client ID 和 Client Secret 正确无误，没有多余的空格
2. 确认用户名和密码是 TTLock 平台的登录账号，不是开放平台开发者账号

时间相关

时间参数应该用什么格式？

推荐使用毫秒时间戳（13 位），特别是在使用 n8n 表达式时。插件也支持秒级时间戳（10 位）和日期字符串（如 2026-05-07 09:00:00）。

注意 n8n 服务器与锁所在位置的时区差异。

示例工作流相关

导入工作流后 TTLock 节点显示红色三角，运行报错提示需要添加凭证？

导入工作流后，TTLock 节点可能显示红色三角警告，运行时提示需要添加凭证。这是 n8n 平台在导入工作流时未正确恢复凭证引用导致的已知问题，凭证本身并未丢失。解决方法：

1. 点击 TTLock 节点，进入节点编辑界面
2. 点击左上角返回按钮或点击画布空白处退出节点
3. 红色三角警告即会消失，恢复正常

导入示例工作流后如何测试？

1. 完成凭证配置（TTLock 凭证 + SMTP 邮件凭证）
2. 修改邮件节点的收发邮箱
3. 激活工作流
4. 使用 curl 或 Postman 发送 POST 请求：

curl -X POST http://你的n8n地址/randomPasscode \
  -H "Content-Type: application/json" \
  -d '{"lockId": "你的锁ID", "keyboardPwdType": 3, "startDate": "2026-05-07 09:00:00"}'

详细步骤参见 流程示例。

不需要邮件通知怎么办？

可以直接删除邮件-成功和邮件-失败节点，将 IF 判断节点的输出直接连接到 Respond 节点。

其他

插件支持哪些 n8n 版本？

需要 n8n >= 1.0.0。建议使用最新稳定版以获得最佳兼容性。