以Python模块安装的Thingsboard网关无法查看统计数据如何解决

1. 官方提示说明 #

if you have installed the gateway as python module - you should just rerun gateway process.
这句的意思是：Python模块方式安装的网关无需通过systemctl管理服务，直接重启网关进程即可生效。你之前执行systemctl重启操作无效，是因为Python模块默认不会自动注册systemd服务，你调用的服务大概率是残留的无效服务，和你安装的Python版本网关没有关联。

2. 命令报错原因 #

你自定义的Python命令和直接执行thingsboard-gateway报错，核心是两个问题：

• 配置文件路径错误：你修改的配置文件路径为/etc/thingsboard-gateway/config/tb_gateway.yaml，但你自定义的Python命令里指定的是当前目录下的./tb_gateway.yaml，程序找不到配置文件必然报错
• 无需手动导入Python类启动，官方已经封装了专用启动命令

3. 具体解决操作 #

按顺序执行以下步骤：

• 第一步：停止并禁用无效的systemd服务，避免端口冲突

sudo systemctl stop thingsboard-gateway.service
sudo systemctl disable thingsboard-gateway.service

• 第二步：确认Python模块安装正常

pip3 show thingsboard-gateway

如果无输出说明安装失败，重新执行安装命令：

pip3 install thingsboard-gateway

• 第三步：用官方指定命令启动网关，指定正确的配置文件路径

sudo thingsboard-gateway -c /etc/thingsboard-gateway/config/tb_gateway.yaml

4. 后续问题排查 #

如果启动仍报错，按以下优先级排查：

• 权限问题：确认你用的用户有读取/etc目录下配置文件的权限，加sudo运行即可
• 配置格式问题：yaml对缩进要求极高，检查tb_gateway.yaml中host、port、accessToken参数是否缩进正确，归属于thingsboard配置节点下，无多余空格或格式错误
• 连接问题：确认TechBase设备可以ping通你配置的host地址，1883（默认MQTT端口）未被防火墙拦截，accessToken和Thingsboard后台创建的网关设备token完全一致
• 启动成功后终端会输出连接成功日志，此时刷新Thingsboard后台的Latest Telemetry标签页即可看到上报数据

5. 后台运行&开机自启配置 #

如果需要网关后台常驻，启动命令改为：

nohup sudo thingsboard-gateway -c /etc/thingsboard-gateway/config/tb_gateway.yaml &

需要开机自启的话，自行创建systemd服务文件，ExecStart字段填写上面的完整启动命令即可。

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