ThingsBoard设备对话框无遥测数据显示（Hello World教程问题）

1. 核对设备凭证正确性 #

• 确认curl命令中的xxx是目标设备的Access Token（可在设备详情的「凭证」标签页复制），而非设备ID、名称或其他类型凭证，确保无空格、大小写错误或特殊字符遗漏。

2. 查看ThingsBoard服务日志 #

执行以下命令实时监控服务日志，发送curl请求后观察是否有异常：

journalctl -u thingsboard.service -f

重点关注：

• Postgresql数据写入失败日志（如权限不足、表结构异常）
• 队列（Kafka/内存队列）处理遥测的报错信息
• 凭证验证后的后续处理流程日志

3. 验证数据库是否已存储遥测数据 #

登录Postgresql数据库检查数据是否写入：

sudo -u postgres psql -d thingsboard

执行查询语句（替换你的设备名称为实际设备名）：

SELECT * FROM ts_kv_latest 
WHERE entity_id = (SELECT id FROM device WHERE name = '你的设备名称');

• 如果查询到temperature字段的记录：说明后端已存储数据，问题出在前端推送或展示环节
• 无记录：说明数据未写入数据库，需排查数据流向的中间环节（队列、DB连接）

4. 检查前端WebSocket连接 #

浏览器打开开发者工具（F12）→「网络」标签，过滤WebSocket：

• 确认/api/ws连接状态为101 Switching Protocols，若连接失败，「最新遥测」无法实时获取数据
• 若使用Apache反向代理，需确保配置WebSocket支持：
  • 启用mod_proxy_wstunnel模块：a2enmod proxy_wstunnel
  • 添加反向代理规则：

    ProxyPass /api/ws ws://localhost:8080/api/ws
    ProxyPassReverse /api/ws ws://localhost:8080/api/ws
    

  • 重启Apache服务：systemctl restart apache2

5. 排查IPv6环境适配问题 #

• 检查ThingsBoard配置文件/etc/thingsboard/conf/thingsboard.conf，确保绑定所有地址：

  bind_address=::
  

• 验证ZooKeeper配置（/etc/zookeeper/conf/zoo.cfg）：

  clientPortAddress=::
  

• 验证Kafka配置（/etc/kafka/server.properties）：

  listeners=PLAINTEXT://[::]:9092
  

确保所有服务均支持IPv6通信，避免因地址绑定问题导致数据流转中断。

6. 清理前端缓存 #

强制刷新浏览器（Ctrl+F5）或清除浏览器缓存后重新登录，排除前端缓存导致的数据不更新问题。

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