4. 常见故障一：深度图全黑或全零——原因分析与排查步骤
做深度相机这么多年，我遇到最多的故障就是——深度图全黑。或者全是零。
你想想看，明明RGB图像看着好好的，深度图却一片漆黑。这时候别慌。我个人的经验是，90%的情况都不是硬件坏了，而是环境或设置出了问题。
4.1 为什么会全黑？三个核心原因
深度图全黑，说白了就是相机没收到有效的光信号。要么是光没回来，要么是传感器罢工了。我把它归纳为三类：
4.1.1 光照过强
这可能是最容易被忽略的原因。很多人觉得「光照强不是看得更清楚吗？」——对RGB相机是这样，但对深度相机恰恰相反。
深度相机（尤其是结构光和ToF）是靠发射红外光、接收反射光来测距的。如果环境光太强，比如大太阳底下，红外光会被淹没。传感器接收到的信噪比太低，直接就放弃治疗了。
典型场景：
- 室外正午阳光直射
- 靠近大功率红外补光灯
- 室内有强红外热源（比如暖气片、白炽灯）
我在项目中遇到过，客户说「我的相机在室外完全不能用」。我过去一看，好家伙，正对着下午两点的太阳。把相机转到背阴处，深度图立马就出来了。
4.1.2 遮挡问题
这个原因更隐蔽。深度相机的发射器和接收器之间有固定的基线距离。如果发射窗口被遮挡，光出不去；接收窗口被遮挡，光进不来。结果都一样——全黑。
嗯，这里要注意：有些遮挡是你肉眼看不出来的。比如相机前面贴了一层保护膜，或者镜头上有指纹、灰尘。红外光穿透力没那么强，一点点污渍就可能让深度图报废。
我曾经踩过的坑：
有一次调试机器人，深度图一直全黑。我查了所有参数、换了三个环境，都没用。最后发现是出厂时镜头上贴的保护膜没撕掉。那层膜肉眼几乎看不出来，但红外光就是穿不过去。折腾了我整整两个小时。
4.1.3 硬件损坏
这是最不想遇到的情况，但确实存在。硬件损坏通常表现为：
- 激光发射器烧毁：长时间过流或静电击穿
- 传感器感光芯片损坏：物理撞击或潮湿导致
- 排线松动或断裂：尤其是机械臂上用的相机，振动容易导致排线接触不良
- USB/数据线故障：供电不足或信号干扰
怎么区分是硬件损坏还是环境问题？我有个简单的判断方法：用手挡住发射器，如果深度图没有任何变化（还是全黑），那大概率是硬件问题。如果手挡住后出现了一点点变化（哪怕只是噪点），那说明硬件还在工作，问题出在别处。
4.2 排查步骤：从易到难
我个人习惯按这个顺序排查，能省下不少时间：
- 检查物理遮挡——先看镜头和保护膜，再看发射/接收窗口
- 检查环境光照——换个室内环境试试，或者用手遮住相机上方
- 检查数据线和供电——换根线，换个USB口
- 检查驱动和固件——重启相机，重装驱动
- 检查硬件状态——用官方工具读取传感器温度、电流等
小技巧：
很多深度相机厂商会提供诊断工具。比如Intel RealSense的Viewer，可以查看红外图像。如果红外图正常但深度图全黑，那问题出在计算模块；如果红外图也是黑的，那问题出在传感器或发射器。
4.3 核心排查逻辑图
下面这张图是我自己总结的排查流程，你可以照着走一遍：
4.4 快速诊断表
为了方便你现场排查，我整理了一个对照表。你可以拿着这个表，一条一条对：
| 现象 | 可能原因 | 快速验证方法 | 解决方案 |
|---|---|---|---|
| 深度图全黑，红外图正常 | 计算模块异常或标定参数丢失 | 重新加载出厂标定文件 | 恢复出厂设置或刷固件 |
| 深度图全黑，红外图也黑 | 发射器或传感器损坏 | 用手电筒照传感器，看红外图是否有反应 | 送修或更换硬件 |
| 室内正常，室外全黑 | 环境红外光过强 | 用遮光布盖住相机上方 | 加装红外滤光片或调整曝光时间 |
| 偶尔全黑，拍一下又好了 | 排线接触不良或USB供电不稳 | 晃动数据线看深度图是否闪烁 | 更换数据线或加固排线接口 |
| 刚开机正常，几分钟后全黑 | 散热不良导致激光器过热保护 | 触摸相机外壳是否发烫 | 加强散热或降低帧率 |
重要提醒：
千万别一上来就拆机。我见过太多人把能用的相机拆坏了。先做软件排查，再做环境排查，最后才考虑硬件问题。这个顺序能帮你省下至少一半的排查时间。
4.5 我的个人经验总结
做深度相机这些年，我总结了一个「三秒法则」：拿到一台全黑的深度相机，先花三秒钟看发射窗口有没有遮挡。就这三秒，能解决30%的问题。
另外，我建议你在项目初期就做好环境光照评估。如果要在室外用，选主动立体视觉方案；如果室内用，ToF和结构光都行。别等到部署了才发现相机「见光死」。
嗯，最后说一句：深度图全黑不可怕，可怕的是没有系统的排查思路。按我上面说的步骤来，大部分问题都能在十分钟内定位。