信创项目交付现场装机翻车本来就是家常便饭但最能让新人当场懵掉的不是分区失败也不是引导丢失而是系统装完了、重启过了、屏幕却黑了。今天说的这台机器是海光 GM9-5602配的是银河麒麟 V11现象非常典型安装过程一路顺风进度条走完自动重启结果显示器直接黑屏连登录界面都没看到。网上查了一圈答案五花八门有让换显卡的有让重装系统的甚至有让升级固件的实际试下来大多不对症。最后问题的根源其实特别简单——内核引导参数里缺了一条显示相关的开关加进去就恢复整个过程不超过五分钟。这篇内容不是什么高深理论就是我实际踩坑之后的解决记录把完整的排查思路和修复步骤写出来。不管你是信创集成商的技术交付、单位里的运维还是自己在家折腾国产系统的爱好者遇到相似的黑屏问题都可以按这个思路走一遍大概率能省掉你重装系统的半天时间。1. 故障现场装完系统自动重启屏幕再也没亮过1.1 现象描述不是完全黑键盘灯还亮着先说清楚当时的具体情况因为黑屏和黑屏之间差别很大排查路径完全不同。这台海光 GM9-5602 算是常见的国产化整机配置处理器是海光的桌面级芯片系统安装用的事银河麒麟 V11 的镜像。安装过程非常顺利分区、复制文件、安装引导这些步骤都没有报警最后一步提示重启我们点了重启。然后问题就来了。机器重新加电之后显示器的灯从橙色变成蓝色说明主板上电自检和信号输出都正常但屏幕上一片漆黑没有光标的闪烁也没有渲染桌面时的渐变效果。这时候我们注意到键盘的三个指示灯都正常按 Caps Lock 键有反应说明机器没有死机、内核也拉起来了纯粹是显示层面出了问题。这种情况大概率不是硬件故障因为如果显卡或输出接口坏了自检阶段就会报警显示器收不到信号也会直接提示无信号。现在的状态是显示器已经锁定了信号但画面停在黑屏属于系统启动到了某个阶段之后图形输出卡住。1.2 排除物理因素的确认顺序开始怀疑系统问题之前先把硬件相关的因素过一遍不然方向很容易跑偏。这台机器是项目上统一验收的设备同一批货里换一台装同样版本的系统有没有同样的问题如果每台都黑屏基本可以排除单台硬件损坏的可能。然后检查视频输出接口海光平台常用的显示输出有 VGA、HDMI、DP 三种有的整机还会带 Type-C 视频输出。我们试了换接口、换线、换显示器现象一模一样所以显示链路本身没问题。到这里就可以确定是操作系统或引导层面的事情开始往软件方向排查。2. 从 tty 里面挖线索先拿到能用的终端再说2.1 CtrlAltF2卡住的图形和能用的字符终端黑屏状态下很多人第一反应是重启但重启之后如果没有修改任何配置结果还是黑屏只会白白浪费时间。正确做法是进入系统的文本终端也就是 tty。方法是黑屏状态下按住 CtrlAltF2大多数 Linux 发行版会切换到一个纯文本模式的登录界面。这台机器试了几次按 CtrlAltF2 确实能调出字符终端进去之后用安装时设置的用户名密码登录系统响应完全正常。这进一步确认了问题出在图形栈而不是系统核心组件损坏。有终端之后很多事情就好办了。先看内核日志里和显示相关的东西我记得当时用的命令是dmesg | grep -i drm\|gpu\|amdgpu\|fbcon输出里面能看到显示驱动在内核阶段加载的记录。正常情况应该能看到显示控制器被成功识别、驱动注册成功、帧缓冲设备创建出来的信息。但这台机器上只看到设备被识别到了后面没有出现 fb0 相关的成功输出驱动加载在中途就断了导致内核没有把显示缓冲交给用户态。2.2 Xorg 日志与 Wayland 日志里的关键差异银河麒麟 V11 的桌面环境同时支持 X11 和 Wayland 会话默认登录管理器会用哪个会话取决于系统的默认设置。黑屏的现象如果发生在 Xorg 环境下通常会在日志里留下明确报错如果是 Wayland 环境日志的位置和格式都不太一样。我们先检查 /var/log/Xorg.0.log使用cat /var/log/Xorg.0.log | grep -i EE\|\(WW\)有报错信息会明显暴露出来。但实际排查中发现 Xorg 日志里只有几行警告没有致命的报错驱动看似正常加载。这时候再看内核日志发现对应显卡设备的固件加载超时也就是说用户态的图形程序从一开始就没拿到可用的显示设备接口。用 lspci 检查 PCI 设备列表lspci -nnk | grep -A 3 -i VGA\|Display可以看到设备识别名、内核驱动绑定情况。正常情况下应该显示 driver in use 是 amdgpu 或其它对应驱动而这台机器上显示内核绑定的驱动不完整等于设备被识别但没有一个可用的驱动接管它的输出。3. 一步修复给内核启动参数加上 nomodeset3.1 临时生效的做法先验证思路对不对既然确认是内核阶段的显示驱动加载出了问题最直接的验证方式就是让内核绕过对显示设备的深度初始化。Linux 内核里有一个叫内核模式设置KMSKernel Mode Setting的机制简单说就是在内核引导阶段就把显示输出模式设定好。如果这一步失败或驱动不匹配画面就会黑掉但系统本身运行正常。nomodeset 参数的作用就是告诉内核先别自己去初始化显示输出把这项工作推迟到用户态或者干脆交给 BIOS 已经设定好的显示模式。这样虽然损失了内核阶段的分辨率切换能力但能绕开驱动加载那一关让系统先进到桌面再说。临时添加参数的方法很经典。开机到 GRUB 引导菜单的时候光标移动到要启动的内核条目上按 e 键进入编辑模式找到以 linux 开头的那一行在行尾加一个空格和 nomodeset然后按 CtrlX 或 F10 启动。# 编辑前大概是这个样子 linux /boot/vmlinuz-xxxx root/dev/mapper/... ro splash quiet # 编辑后 linux /boot/vmlinuz-xxxx root/dev/mapper/... ro splash quiet nomodeset保存启动之后屏幕上能看到字符模式的引导日志滚过接着显示登录界面说明这条路走通了。这台机器在加了 nomodeset 后顺利进到桌面分辨率虽然是 BIOS 提供的默认值但所有界面操作都正常鼠标、键盘、窗口渲染都没问题。3.2 持久化配置让每次开机都自动带这个参数临时验证有效之后问题就变成怎么让这个参数每次开机自动带上。不能每次开机都手动按 e 改参数那不符合交付要求。银河麒麟 V11 基于 Debian 系架构GRUB 的持久化配置在 /etc/default/grub 文件里。用编辑器打开它找到 GRUB_CMDLINE_LINUX 这一行把 nomodeset 加进去sudo nano /etc/default/grub这一行修改后大概长这样GRUB_CMDLINE_LINUXquiet splash nomodeset保存之后执行sudo update-grubupdate-grub 会重新生成 /boot/grub/grub.cfg把家的配置合并到真实的引导配置里。执行完看到有新内核版本被 scan 到、配置更新完毕的提示就说明写入成功了。重启验证一次系统应该直接进入桌面不需要任何手动干预。提示有的项目环境里这台机器的引导可能走的是 EFI 分区下的 grub.cfg语法逻辑都是同一套。只要确认 /etc/default/grub 改对了update-grub 执行完就能生效。4. 为什么要加这个参数KMS 加载顺序和海光的特殊脾气4.1 Linux 显示栈的分工与 KMS 的角色要理解 nomodeset 为什么能救回来得先简单了解一下 Linux 的显示栈。图形输出链条从内向外大致是显示控制器硬件、内核 DRM 驱动、内核帧缓冲、用户态图形协议X11/Wayland、桌面环境。中间最关键的一环就是 DRM 子系统和它的 KMS 机制。KMS 让内核在启动早期接管显示控制器的初始化工作包括设置分辨率、颜色深度、显示时序等。好处是启动过程平滑、无闪屏、支持内核日志的屏幕输出代价是驱动一旦有问题或者固件加载顺序不对整个显示输出就卡在内核阶段画面黑掉但系统还在跑。我们遇到的情况就是典型的 KMS 初始化中断。海光平台使用的整合显示核心在部分 Linux 内核版本下固件加载会等待一个超长的超时时间如果固件没有按时响应内核就放弃了显示输出设备的完整初始化结果就是黑屏。4.2 为什么别的机器没事这台就翻车很多人在项目里会遇到一个困惑同一批机器同一个镜像有的装完没问题有的装完黑屏。这不是玄学通常是不同硬件版本、不同固件版本之间的兼容性差异导致的。海光桌面平台有一些细分型号显示控制器的 PCI ID 不完全相同Linux 内核版本对它们的支持程度也一直在迭代。如果这台 GM9-5602 出厂时的固件版本较新而系统镜像自带的内核版本相对旧就可能出现固件接口变化导致的加载超时。加 nomodeset 本质上是让内核别去挑战新固件的接口把显示模式交给 BIOS 事先设定好的状态从而避开兼容性的坑。性能方面加了 nomodeset 确实会影响启动阶段的画面切换细腻度但进入桌面之后的图形渲染依然由用户态驱动和 GPU 硬件完成日常办公、浏览器、视频播放这些场景不会感觉到明显差异。这是为什么这个解决办法在信创交付里特别实用——它不追求极致的启动体验要的是稳定把桌面带起来。4.3 网上很多解法为什么不对症搜索类似问题时经常看到有人建议修改 xorg.conf、切换显示管理器、重装图形驱动甚至直接换系统版本。这些办法不是完全没用但应用场景和我们遇到的不一样。xorg.conf 的修改只能影响 X11 会话的显示输出如果黑屏发生在内核引导阶段那根本走不到 X11 那一步切换显示管理器类似它影响的是登录界面的启动照样等不到那一步重装驱动在这个场景里更是南辕北辙因为设备本身已经被内核识别缺的不是驱动文件而是驱动初始化的正确时机。这也是为什么很多人在这些方向上来回折腾数小时都没有进展看起来每个答案都有道理但都没打中真正的痛点。5. 修完不算完后续加固与同类问题的排查思路5.1 内核升级后参数可能被保留但驱动更新要重新验证修好之后要注意一个现实问题银河麒麟 V11 的软件源会持续推送内核更新每次升级之后 grub.cfg 会重新生成之前写进 /etc/default/grub 的 nomodeset 会自动保留到新内核的启动参数里所以一般不会出现升级后黑屏复发。但驱动层面的事情就复杂一些。如果系统推送了内核内置显卡驱动的更新新驱动对这台海光平台的固件支持有可能改善之前需要 nomodeset 才能进桌面这个行为也许就不再必要。更新驱动后可以找个时间手动移除 nomodeset 参数再重启验证一下 KMS 是否能正常初始化。如果没问题就移除留着反而更稳妥。一线交付环境的原则是能稳定运行就不要主动折腾。5.2 同批机器的批量处理及时固化镜像信创项目通常不是单台交付而是一批几十台上百台。像 GM9-5602 配合银河麒麟 V11 这个组合如果第一台确认需要 nomodeset后续其他机器大概率也逃不掉。处理思路是把这个配置固化到装机源里。具体做法有两种一种是对已经装好的机器执行完前面的步骤用系统自带的备份工具做成镜像再做批量还原另一种是修改装机时的 Kickstart 或 AutoYast 应答文件在引导参数里预先写入 nomodeset这样从安装阶段就直接生效。我们实际采用的是第二种在启动安装器的时候直接把参数带进引导linux /casper/vmlinuz file... quiet splash nomodeset这样所有后续装的机器都自带这个参数可以免去反复手工配置的环节。5.3 这个排查方法在其他信创平台上的扩展虽然标题写的是海光 GM9-5602 和银河麒麟 V11 的组合但排查思路完全可以套用到其他国产化平台上。飞腾、鲲鹏、龙芯等平台搭配银河麒麟或统信 UOS如果出现装完系统进桌面黑屏、但键盘灯正常的现象第一步都应该先按 CtrlAltF2 进 tty再看 dmesg 里和 drm、gpu 相关的输出最后用 nomodeset 做验证。有一点需要提醒部分 ARM 架构的国产平台对 nomodeset 的支持不如 x86 平台完整如果加上之后依然黑屏还可能需要配合其他参数比如 disabling modifier or forcing the EFI framebuffer。不过对于 x86 生态的海光平台来说nomodeset 是优先级最高的尝试项成功率非常可观。排查步骤操作方式预期结果物理链路确认换接口、换线、换显示器确认黑屏与硬件链路无关进入字符终端CtrlAltF2确认系统内核正常运行查看内核日志dmesg grep drm/gpu定位驱动加载中断位置检查设备绑定lspci -nnk确认显示设备被识别但驱动不完整临时加参数GRUB 编辑加 nomodeset验证是否能进入桌面持久化配置修改 /etc/default/grub每次开机自动生效重建引导配置update-grub配置写入 grub.cfg整个过程走下来真正动手修复的时间其实很短难的是在错误方向上浪费时间。我自己在刚处理这类问题的时候也走过弯路第一反应是怀疑硬件故障拆机换了好几根线后来才反应过来键盘灯亮着、系统能进 tty问题多半不在硬件上。现在遇到黑屏我先问三个问题键盘能不能切换终端、dmesg 里有没有显示相关的错误、加 nomodeset 能不能正常进桌面。按照这个顺序排查绝大多数海光、飞腾平台的桌面黑屏都能找到对应解法不用动不动就重装系统。
