本篇主角长这样
适用于产品： 幻尔科技 ClawPi 智能视觉小车
涉及模块： 树莓派5主控、LCD屏幕
一、问题描述
ClawPi智能视觉小车在通过独立脚本send_lcd_image.py直接读取本地图片文件，通过Socket将图片数据发送给LCD显示服务，实现图片显示时，会出现各种异常，本帖子将教学如何排查异常。
二、问题说明
在使用这个功能时会出现 图片路径错误、 图片文件为空或读取失败、 LCD服务不可用、 LCD服务拒绝显示请求、 恢复失败等这些异常情况，下面将说明如何处理这些异常情况的方法
三、解决办法
- 图片路径错误
报错提示：send_lcd_image.py: error: image file not found: 图片路径
排查：确认目标图片真实存在，建议填写文件绝对完整路径，避免相对路径带来的定位问题。 - 图片为空 / 文件读取失败
报错特征：以send failed:开头，示例：send failed: imagefile is empty
排查：校验图片文件本身是否损坏，同时检查脚本对该文件是否具备读取权限。 - LCD 显示服务不可连接
报错特征：以send failed:开头的连接类错误
排查：确认已经进入对应 Docker 容器，并且127.0.0.1:8765的 LCD 显示服务正常启动运行。 - LCD 服务拒绝显示请求
报错提示：LCD error: ...
排查：根据服务返回的具体报错信息，进一步定位 LCD 服务侧问题。 - LCD 恢复失败（Ctrl+C 退出异常）
报错提示：LCD restore error:/LCD restore failed:
现象：按Ctrl+C终止脚本后，LCD 无法退出图片接管状态、恢复原有显示
排查：先保证 LCD 服务运行正常，重新运行图片显示脚本，再使用Ctrl+C退出。
四、资料下载
可通过以下途径获取：
-
官方在线课程与资料库： 幻尔科技官网在线教程 -
客服领取： 联系你购买设备的店铺客服（淘宝/京东/天猫客服），提供订单号即可免费领取资料。