Cases
面向开发板实际使用场景的问题解答：启动、联网、外设、部署和维护。
这里先收录开发板使用中最常见的问题。形式以问答和简短记录为主，后续可以按板卡、系统、外设、错误现象继续扩展。
板卡单独运行正常，接 USB 硬盘或摄像头后开始不稳定。
树莓派 5 接了一个移动硬盘，系统能启动，但运行一会儿会重启，是系统问题还是硬件问题？
先按供电和外设瞬时电流排查。把硬盘、摄像头、USB 集线器全部断开，只保留系统盘启动；如果稳定，再逐个接回外设。供电不足、线材压降、外设启动电流过大，都会让问题看起来像系统崩溃。
HDMI 有画面，路由器里也能看到设备，但远程登录失败。
开发板能进系统，为什么电脑上还是 SSH 连接不上？
先分清楚是网络没通、SSH 服务没开，还是用户名/地址写错。不要一开始就重装系统，先在路由器或本地终端确认 IP，再确认系统镜像是否默认开启 SSH。不同发行版的默认策略不一样，这一步最容易踩坑。
容器显示正在运行，但局域网电脑访问页面失败。
Docker 里服务已经跑起来了，为什么浏览器输入开发板 IP 还是打不开？
这种情况通常不是“Docker 没启动”，而是端口映射、监听地址或防火墙策略不对。先看服务实际监听的端口，再看容器端口有没有映射到宿主机，最后确认服务是否只监听本机回环地址。
代码没有报错，但传感器读数一直为空或固定不变。
GPIO 资料照着接了，为什么传感器还是没反应？
先不要急着改代码，GPIO 问题大多要先核对供电电压、针脚编号和总线类型。物理针脚编号、BCM 编号、库里的编号方式经常混在一起；传感器如果需要 I2C、SPI，也要确认对应接口已经启用。
排线已经插入，但应用里没有摄像头画面。
树莓派摄像头插上以后没有画面，是不是摄像头坏了？
先检查排线方向、接口类型和系统支持，不要直接判断硬件坏。Raspberry Pi 5 的摄像头/屏幕接口和旧款板卡配件不完全一样，排线、转接线、系统版本都会影响识别结果。
安装了 M.2 HAT 和 SSD，但系统里没看到预期的存储设备。
树莓派 5 加了 NVMe HAT，为什么没有看到硬盘？
Raspberry Pi 5 支持通过 PCIe 扩展 NVMe，但不是裸板直插。先确认 HAT、排线、SSD 供电和系统配置都正确，再看启动顺序和系统是否识别到 PCIe 设备。不同 HAT 的安装方式和兼容性也需要单独确认。
