当你设置好全新的树莓派 5 后，键盘却开始出现延迟、按键重复或无响应等问题，兴奋之情很快就会被沮丧所取代。这个问题比你想象的要常见得多，尤其是在混用不同的操作系统、使用劣质 USB 集线器、采用不常见的控制台配置，或者使用刚刻录但启动不正常的镜像文件时。
本文将详细探讨树莓派 5 键盘故障最常见的原因，涵盖 OpenBSD、Fedora 和树莓派 OS 等系统上的实际案例，以及首次启动时鼠标和键盘均无法检测到的情况。您将找到一些简单易用的技巧和实用建议，以及针对远程系统管理人员的远程故障诊断和修复方法，无需亲临现场即可解决问题。
树莓派 5 常见键盘问题：症状和早期征兆
在树莓派 5（及更早型号）上，键盘故障很少只表现为一种形式：轻则打字延迟，重则完全失去对输入设备的控制。准确识别故障症状是避免盲目尝试、徒劳无功的关键。
最令人沮丧的情况之一是系统似乎出现延迟：你按下一个键，字符要过一两秒才会出现在控制台或图形窗口中。有时甚至会出现按键丢失的情况，比如你输入一个单词，但明明按下了某个字母，却发现它不见了。
与此相关的另一个非常典型的症状是：按键卡住。你突然按住字母“a”或空格键片刻，松开后，系统会像你一直按住键一样持续输入同一个键。硬件没有问题，但软件却表现得好像按键操作没有完成。
在某些环境下，这些问题既会出现在文本控制台 (tty) 中，也会出现在图形环境（例如 BSD 系统上的 X11 或 Linux 发行版上的 Xorg/Wayland）中。这有助于排除某些问题仅仅是特定程序的 bug，而更多地指向驱动程序、中断或 USB 管理方面的问题。
在其他情况下，问题甚至更加严重：从使用新烧录的镜像首次启动显卡开始，鼠标和键盘都毫无反应。系统看似正常运行（可以看到指示灯亮起，甚至屏幕上可能出现桌面），但由于所有 USB 输入设备都未被识别或初始化，因此无法进行任何交互。
实际案例：树莓派上 OpenBSD 系统键盘运行不稳定
一个非常典型的例子是基于 CM4 计算模块的树莓派，一位用户报告称，在树莓派类型的硬件上运行的 OpenBSD 7.1 系统出现了奇怪的行为。虽然这篇文章主要讨论的是树莓派 5，但这个例子有助于理解，问题可能并非出在键盘本身，而是出在操作系统、驱动程序和控制台配置的组合上。
在那种特定情况下，用户描述了键盘的行为完全无法预测：有时打字反应极其缓慢；有时它会跳过已按下的字母；有时甚至在松开按键后还会继续重复上次的按键操作。这种情况在文本终端和 X 图形窗口中都会发生。
他做的第一件事几乎是所有人都会做的：尝试不同的USB键盘。他用了一个苹果有线键盘、一个Trust PC键盘，以及一个树莓派套件里附带的廉价USB键盘。结果都一样：问题出在树莓派上，而这些键盘在他的Mac电脑上都能完美运行。
为了排除电路故障，我们还检查了连接路径：键盘通过一个廉价的 USB 集线器连接到CM4 I/O 板上的 USB 2.0 端口。移除集线器，将鼠标和键盘直接连接到主板上的 USB 2.0 端口后，问题仍然存在。
此人甚至检查了特定的 OpenBSD 配置细节，例如在 /etc/boot.conf 中添加“set tty fb0”指令，并禁用 /etc/ttys 中的“console”条目，正如该架构的 INSTALL.arm64 指南中所述。即便如此，系统行为仍然不稳定，这表明可能存在底层错误或系统与特定硬件不兼容。
他分享的 dmesg 文件显示了所涉及的 USB 设备：DWC2 控制器、串联的 USB 集线器、PixArt 光电鼠标以及一个名为“SEM USB Keyboard ”的通用 USB 键盘。系统能够识别主键盘设备 (ukbd) 和与同一键盘关联的另一个辅助设备，并且支持特殊按键和一个额外的 HID 设备。一切看起来都很正常，但实际上，系统运行并不稳定。
初步诊断：是键盘硬件、USB 集线器还是操作系统的问题？
当遇到这种类型的故障时，无论是在 Raspberry Pi 5 上使用 OpenBSD、Fedora、Raspberry Pi OS 还是任何其他发行版时，首先要做的是将问题分解成几个部分：是键盘、电缆、集线器还是操作系统的物理问题？
第一条建议虽然简单却非常实用，就是尝试在不同的设备上使用同一键盘：例如台式电脑、笔记本电脑、运行不同操作系统的另一台树莓派，甚至是支持 USB 键盘的智能电视。如果键盘在所有这些设备上都能流畅运行且无任何错误，那么基本可以断定键盘硬件没有问题。
如果没有其他电脑可用，至少尝试用不同的操作系统启动同一台树莓派 5。例如，如果您使用的是 Fedora ARM 镜像，但键盘或鼠标无法识别，请尝试使用 Raspberry Pi OS（32 位或 64 位）或其他更轻量级的发行版。这样，您可以检查更换软件后问题是否仍然存在，或者是否仅在特定组合下才会出现。
如果键盘在其他设备上测试时也出现故障，则问题很可能纯粹是硬件相关的：例如薄膜损坏、内部电缆断裂、连接器松动等等。在这种情况下，除非键盘特别昂贵或属于高端机械键盘，否则最实际的选择通常是购买一个新的，而不是花费时间和金钱进行维修，而且维修也并非总是可行。
反之，如果键盘在其他地方工作正常，则需要仔细检查树莓派环境：低质量的 USB 集线器、电源不足、不稳定的 USB 驱动程序或不正确的控制台配置都可能是造成最奇怪症状的原因。
当树莓派 5 上的 Fedora 系统无法识别键盘或鼠标时
另一种经常出现的情况是，在树莓派 5 上新刷入 Fedora Workstation for ARM 镜像后，首次启动时既检测不到鼠标也检测不到键盘。与之前的情况不同，这里不是按键缺失，而是从一开始就完全没有响应。
想象一下，你将一个 Fedora 系统镜像写入一张全新的 microSD 卡，然后将其插入你的 Raspberry Pi 5，启动设备。屏幕上出现了欢迎界面，但鼠标指针纹丝不动，键盘也完全没有反应。你已经尝试过重启、更换 USB 端口以及使用不同的键盘和鼠标组合，但结果仍然一样。
在这种情况下，人们通常首先会检查输入设备是否真的损坏。然而，在很多情况下，这些键盘和鼠标在树莓派操作系统中都能正常工作，甚至在树莓派的引导加载程序中也能用于浏览菜单，这表明硬件层面一切正常。
在此背景下，需要注意的是，每个适用于 ARM 架构的 Linux 发行版对 Raspberry Pi 5 的支持程度各不相同，尤其是在该发行版支持的 Raspberry Pi 5 版本较新的情况下。可能缺少内核模块或特定固件，或者内核与硬件的组合不够成熟，导致某些 USB 控制器无法正确初始化。
也可能是该发行版需要特定的启动配置、对启动文件的修改，或者使用特定版本的树莓派固件。又或者，这个版本的 Fedora 更适合其他 ARM 开发板，与树莓派 5 的兼容性仍然不完整。
遇到这种情况，一个好办法是启动一个已知在 Raspberry Pi 5 上运行良好的系统（例如 Raspberry Pi OS），然后检查 USB 端口是否能正确识别设备。如果在这个系统中键盘和鼠标都能正常工作，那么问题很可能出在 Fedora 对该特定硬件组合的支持状态上，而不是你的 Raspberry Pi 或你的初始设置上。
某些情况下，使用 microSD 卡“从头开始”会很有帮助
有时，经过多次尝试后，解决方案可能很简单，只需格式化 microSD 卡，将引导程序或发行版复制回去，然后重启即可。一个明显的例子是，有人使用 BerryBoot 管理树莓派上的多个系统，突然无法访问键盘和鼠标，最终通过重新安装 microSD 卡上的内容解决了问题。
在这种情况下，用户按照文本文件中的建议，将特定的配置行复制到了系统文件中。这种修改并没有解决任何问题，最坏的情况下，甚至可能导致启动配置损坏。即便如此，在擦除 microSD 卡、恢复 BerryBoot 内容并允许引导加载程序重建其环境后，键盘和鼠标恢复了正常工作。
这让我们想起一个重要的理念：编辑启动文件、控制台配置文件或内核参数时出现的小错误，即使硬件正常，也可能导致系统处于输入设备无法正确初始化的状态。
因此，如果多次尝试后仍然找不到问题的原因，不妨考虑采取一种彻底的方法：备份所有重要数据，清理存储卡，然后重新烧录系统或引导程序镜像。这种方法比继续进行随机测试要快得多，而且在很多情况下，可以解决存储卡静默损坏或配置不稳定的问题。
另外，请记住microSD卡并非永久耐用。经过多次写入循环后，它们的性能会开始下降，并可能出现读写错误，这些错误会以非常奇怪的方式表现出来，例如程序损坏或关键服务无法正常启动。如果您怀疑是卡的问题，那么尝试使用一张全新的卡是合乎逻辑的做法。
树莓派 5 远程键盘故障排除
树莓派经常被用于一些不方便放在桌面上的环境。它通常被隐藏在电视机后面、电脑机箱内、墙壁高处或面板中。在这些情况下，一旦出现故障导致本地键盘无响应，物理接触设备就会非常麻烦。
这就是为什么越来越多的人选择远程故障排除的原因。其原理很简单：无需每次出现问题都连接显示器、键盘和鼠标，只需使用远程访问工具，即可通过笔记本电脑、台式电脑甚至手机登录到树莓派，就像您坐在它旁边一样。
传统的连接方式包括 SSH、VNC，以及树莓派专用的Raspberry Pi Connect等解决方案。SSH 对于熟悉终端操作的用户来说非常方便，但如果需要查看整个桌面或为技术水平较低的用户提供支持，它就显得力不从心了。VNC 提供图形界面，但通常存在延迟高、图像质量差等问题，而且需要配置端口、防火墙和网络设置，这些设置并非总是简单易行。
有些人选择设置 VPN 或在路由器上开放端口，以便从本地网络外部访问自己的电脑。但这不仅配置和维护起来很麻烦，而且如果操作不当，还会带来一定的安全风险。归根结底，如果您只是想快速登录，查看桌面，并花点时间摆弄一下键盘或服务问题，这些方法可能就不够用了。
在此背景下，一些旨在提供更流畅的远程桌面体验的替代方案应运而生，这些方案侧重于性能、易用性和安全性。其中最广泛使用的方案之一是 Splashtop，它通过其 Linux Streamer 组件专门支持 Raspberry Pi。
当键盘故障时，可以使用 Splashtop 访问和修复您的 Raspberry Pi。
Splashtop 提供了一种简单易用的方式，让您能够像坐在树莓派前一样控制它的整个桌面，而且支持 Windows、Mac、Android、iOS 甚至 Chromebook 等各种设备。无需繁琐的配置，您只需在树莓派上安装 Linux Streamer，然后在连接设备上使用 Splashtop 应用即可。
最大的优势在于无需配置端口转发、设置 VPN 或安装额外的 VNC 服务器。系统本身可以处理常见的 NAT 和家庭防火墙，因此即使树莓派位于普通路由器之后，您也可以访问它，而无需手动打开任何端口。这大大简化了业余爱好者、教师或技术人员管理分布在多个地点的设备的操作。
在性能方面，Splashtop 经过优化，即使在网络连接不太理想的情况下也能提供低延迟和相当流畅的体验。对于键盘诊断、配置菜单、软件包更新或从桌面查看日志等任务，其体验通常更接近于本地连接，而非其他传统的远程桌面系统。
安全性也是该设计的核心：会话采用256 位 AES 加密、双重身份验证和设备验证进行保护。这样，您无需将 Raspberry Pi 直接暴露在互联网上，也无需依赖弱密码；Splashtop 的层充当安全的中间层，让您可以从任何地方登录，而无需承担不必要的风险。
对于管理多台 Raspberry Pi 5（或新旧型号混合）的用户来说，Splashtop 增添了更多价值：通过单一界面，您可以查看所有设备、连接它们、重启它们、传输文件或启动更新。例如，如果您已部署多台 Raspberry Pi 5 作为信息亭或信息面板，突然发现其中一台的 USB 键盘无法工作，您可以远程连接、查看系统日志、检查驱动程序状态并应用更改，而无需亲自前往现场。
这种远程访问方式不仅在键盘故障时有用，而且对于“无头”树莓派（无需连接键盘或显示器）来说，也是一种非常便捷的入门级操作方式。您可以安装和配置操作系统、微调 USB 设置、测试不同的内核或驱动程序组合，并做好一切准备，即使设备最终被藏在盒子或通讯柜里。
避免和缓解树莓派 5 键盘问题的最佳实践
除了具体案例之外，还有许多指导原则可以大大降低 Raspberry Pi 5 上出现键盘无响应或行为异常的可能性，无论你运行的是什么操作系统。
首先，这一点显而易见但至关重要：务必使用官方或经过验证的优质电源，确保其能够提供树莓派 5 所需的电流，尤其是在连接多个 USB 设备时。电源不足会导致 USB 控制器间歇性崩溃、端口断电，或者某些设备随机断开并重新连接。
关于电源方面，如果您计划连接键盘、鼠标和其他外设，最好避免使用非常廉价或无源的USB集线器。不可靠的集线器可能会导致意外延迟、信号错误、断连，甚至在高负载下导致USB控制器崩溃。如果您需要多个端口，请选择信誉良好的品牌生产的带外接电源的集线器。
软件方面，保持操作系统更新至关重要：包括内核、树莓派固件、系统软件包和驱动程序。活跃的发行版会很快修复与 USB 支持、电源管理和板级控制器相关的错误，因此使用最新的稳定版本可以降低遇到异常情况的概率。
在 Raspberry Pi 5 上使用不太常见的系统（例如 OpenBSD 或其他 BSD 变体，或适用于 ARM 的通用 Linux 发行版）时，请仔细阅读该开发板的具体文档：启动参数、控制台配置、/etc/ttys 的更改、boot.conf 条目等。一个简单的错误设置就可能干扰系统在文本模式和图形环境下处理键盘作为控制台的方式。
最后，千万不要低估快速备份和准备一张装有可用系统的“救援”microSD卡的重要性。如果出现意外情况，例如键盘突然丢失，您可以从这张应急卡启动，检查硬件是否正常工作，然后在不失去对局面控制的情况下，恢复或分析主系统上发生的情况。
虽然树莓派 5 的键盘问题令人非常沮丧，但实际经验表明，几乎总有解决办法：从仔细检查硬件和电源，到重新安装或更换操作系统，再到使用 Splashtop 等远程访问解决方案来诊断和解决问题（即使没有连接键盘）。只要掌握一些方法并保持耐心，树莓派很少会因为键盘问题而永久无法使用。
