1. 国产平台装机翻车现场为什么装完就黑屏手里拿到一块搭载海光处理器的 GM9-5602 主板准备装银河麒麟 V11 桌面版整个过程前半段顺利得让人放松警惕——引导盘识别正常分区、拷贝文件、重启一气呵成。结果重启之后屏幕一片漆黑显示器指示灯从蓝变橙进入省电模式键盘大小写灯能切换说明系统其实在跑只是画面出不来。这个现象在国产化整机装配里非常典型我前后经手过好几套类似配置黑屏几乎成了绕不开的第一道坎。先把结论摆在前面这类黑屏绝大多数不是系统没装好而是显示输出通道选错了。GM9-5602 这块板子同时存在板载集显集成在海光 SoC 内部和独立显卡插槽BIOS 里默认的初始显示设备往往指向独显或者 PCIe 设备而银河麒麟 V11 安装镜像在引导阶段用的是通用显示驱动能点亮一旦进入正式系统内核加载了针对海光平台的显示模块输出通道和 BIOS 的设定对不上画面就没了。理解这一点后面所有操作才有方向。很多人第一反应是重装系统甚至怀疑镜像损坏、U 盘有问题。我实测过同一块板子、同一个镜像换一种显示输出配置就能正常进桌面重装十遍也没用。所以遇到黑屏先别急着格盘按下面的顺序排查能省下大量时间。这篇文章面向的是正在做国产平台适配的运维、整机装配人员以及第一次接触海光平台想自己折腾的爱好者。我会把从 BIOS 设置、内核参数调整到集显驱动加载的完整链路讲清楚包括我踩过的几个隐蔽坑比如内核命令行里那个容易被忽略的参数、驱动模块加载顺序、以及显示管理器配置文件的改动位置。看完你应该能独立把这块板子的集显跑起来。需要提前说明的是海光平台基于 x86 架构但它的集显驱动栈和常见的 Intel、AMD 集显并不一样银河麒麟 V11 针对这类国产平台做了专门的适配包这些包在标准镜像里不一定默认启用需要手动确认。下面进入正题。2. 先别急着重装黑屏问题的分层排查思路2.1 判断系统到底有没有真正启动黑屏最怕的是分不清系统没起来和系统起来了但没显示。这两者的处理路径完全不同。我的习惯是先接一根网线从另一台机器 ping 一下这台设备的 IP或者直接看路由器后台有没有新设备上线。如果能看到设备获取到 IP甚至能 SSH 上去那基本可以确定系统已经正常启动问题纯粹出在显示输出上。另一个更直接的办法是观察键盘。按一下 Num Lock 或者 Caps Lock如果指示灯能正常切换说明内核已经接管了输入设备系统处于运行状态。GM9-5602 这块板子我实测过黑屏时大小写灯切换是正常的这就排除了系统崩溃的可能。还有一种情况是屏幕能显示厂商 logo 和引导菜单但一进系统就黑。这种属于引导阶段正常、内核阶段失败问题集中在显示驱动或者输出通道切换上。把这两种现象区分开排查范围能缩小一大半。2.2 显示输出通道的三种可能GM9-5602 的显示输出大致有三种组合方式每种对应的处理策略不同输出方式现象处理方向仅板载集显输出BIOS 默认可能不指向它改 BIOS 初始显示设备仅独显输出集显被屏蔽或未加载驱动确认独显驱动或强制集显双输出同时存在系统把画面送到了另一个口指定主输出或关掉多余通道我遇到的那次黑屏就是第三种情况板子上插了一张独立显卡显示器接在集显的 HDMI 口上但系统默认把画面输出到了独显的接口。显示器接的是集显口自然什么都看不到。把线换到独显口画面立刻出来了。这个坑说起来简单但当时我盯着黑屏愣了十几分钟才反应过来。所以第一步永远是确认你的显示器接在哪个物理接口上以及系统实际往哪个接口输出。如果板子有多个视频输出口挨个试一遍成本最低。2.3 用 Live 环境验证硬件本身没问题如果手头有银河麒麟的 Live 安装盘可以直接进 Live 桌面看看显示是否正常。Live 环境用的是通用显示驱动能点亮说明硬件和接口都没问题问题出在安装后的系统配置上。这一步能帮你排除掉主板视频口坏了显示器不兼容这类硬件层面的怀疑。我一般还会在 Live 环境里跑一下lspci | grep -i vga看看系统识别到了几个显示控制器。GM9-5602 正常情况下会列出集显和独显两个设备。如果只看到一个说明另一个在 BIOS 层面就被禁用了需要回去改设置。提示Live 环境能显示不代表装完就能显示因为 Live 用的是 framebuffer 通用驱动正式系统加载的是平台专用驱动两者行为可能不同。但 Live 能显示至少证明硬件通路是通的。3. BIOS 层面的显示设备优先级设置3.1 找到初始显示设备选项GM9-5602 的 BIOS 里显示相关设置通常在 Advanced 或者 Chipset 菜单下选项名可能是 Primary Display、Init Display First 或者 Primary Video Device。这个选项决定了开机时系统优先初始化哪个显示设备。默认值往往是 Auto 或者 PCIe也就是优先独显。如果你只用集显需要把它改成 Onboard、IGD 或者 Integrated Graphics。改完之后保存重启很多时候黑屏问题直接消失。这一步是整个排查里性价比最高的操作三十秒就能完成。我那次的情况是 BIOS 里设的是 Auto板子插了独显于是系统把独显当主输出。但我的显示器接在集显口两边对不上。把 Primary Display 改成 Onboard 之后集显口正常出画面。3.2 集显显存分配与共享内存设置海光平台的集显没有独立显存是从系统内存里划一块出来用。BIOS 里一般有 UMA Frame Buffer Size 或者 Integrated Graphics Share Memory 这样的选项可选 32M、64M、128M、256M、512M 甚至 1G、2G。这个值设得太小进系统后可能因为显存不足导致显示异常或者分辨率上不去。我的建议是至少给 256M如果要做图形界面或者多屏给 512M 或 1G。代价是系统可用内存相应减少但对于现在动辄 16G、32G 的内存配置来说这点开销可以接受。设完之后记得保存有些板子改这个选项需要冷启动才生效热重启可能不认。3.3 关闭独显或调整 Above 4G Decoding如果确定只用集显可以在 BIOS 里把独显相关的选项关掉减少系统识别混乱的可能。另外 Above 4G Decoding 和 Resizable BAR 这类选项在国产平台上有时候会影响显示设备的地址分配如果开了之后黑屏可以试着关掉。我遇到过一块板子开了 Above 4G Decoding 之后集显就点不亮关掉恢复正常。这个选项本身是为了让系统能访问 4G 以上的 PCIe 设备地址空间对独显性能有帮助但对集显输出可能有副作用。国产平台的 BIOS 实现各家不同遇到问题可以拿这个选项做实验。注意改 BIOS 之前记一下原始值改完不生效或者出问题可以改回去。国产主板 BIOS 的选项命名不太统一同一个功能在不同版本里叫法可能不一样以实际界面为准。4. 内核启动参数黑屏修复的关键一刀4.1 进入 GRUB 编辑模式系统装完之后如果黑屏但能进 GRUB 菜单开机时按 Esc 或者 Shift 调出就可以在启动参数上做文章。选中要启动的内核条目按e进入编辑模式找到以linux开头的那一行行尾就是内核启动参数。这一步是临时修改只对本次启动生效用来验证参数是否有效。验证通过后再写进配置文件永久生效。我习惯先用临时修改试确认能进桌面了再固化避免改错配置导致系统起不来。4.2 添加 nomodeset 与视频参数最常用的应急参数是nomodeset它让内核不要加载显示模式设置驱动改用 BIOS 或者固件提供的显示模式。加上之后很多黑屏能立刻进桌面但代价是分辨率可能不对、性能差、无法用硬件加速。它是个诊断手段不是最终方案。linux /vmlinuz-xxx root/dev/mapper/xxx ro nomodeset如果nomodeset能进系统说明问题确实出在显示驱动上。接下来可以尝试更精确的参数比如指定视频输出接口videoHDMI-A-1:1920x108060或者针对海光集显指定驱动模式。银河麒麟 V11 的内核里海光集显对应的驱动模块名和常见平台不同需要先确认模块是否加载。4.3 确认集显驱动模块是否加载进系统之后哪怕是nomodeset进的打开终端跑lsmod | grep -i drm lsmod | grep -i gpu dmesg | grep -i drm看看有没有和海光显示相关的模块。银河麒麟 V11 针对国产平台通常会带hygon或者类似的 DRM 驱动。如果lsmod里什么都没有说明驱动没加载需要手动modprobe或者检查模块是否被加入黑名单。我那次的情况是驱动模块存在但因为 BIOS 输出通道设置不对模块加载后找不到对应的显示接口于是黑屏。把 BIOS 改对之后模块正常绑定画面就出来了。所以内核参数和 BIOS 设置要配合着看不能只盯一头。提示dmesg | grep -i drm的输出里如果看到 no outputs found 或者 connector not found 之类的字样基本可以确认是输出通道问题回去查 BIOS 和物理接口。5. 集显驱动加载与显示管理器配置5.1 确认驱动包是否安装完整银河麒麟 V11 的软件源里针对海光平台的显示驱动通常打包在mesa、libdrm以及厂商特定的驱动包里。用下面的命令确认dpkg -l | grep -i mesa dpkg -l | grep -i drm dpkg -l | grep -i hygon如果发现关键包缺失用apt补装。注意银河麒麟的源配置和通用发行版不同要确保源地址正确否则会提示找不到包。我遇到过源里只有基础 mesa 没有平台专用驱动的情况需要从安装镜像的 pool 目录里手动找 deb 包安装。5.2 显示管理器与 Xorg 配置如果驱动加载正常但进桌面还是黑屏问题可能出在显示管理器LightDM、GDM 之类或者 Xorg 的配置上。银河麒麟 V11 默认用的显示管理器可以在/etc/X11/default-display-manager里看到。Xorg 的配置在/etc/X11/xorg.conf或者/etc/X11/xorg.conf.d/目录下。如果系统自动探测的输出不对可以手动写一个配置指定使用集显设备Section Device Identifier Hygon GPU Driver modesetting BusID PCI:0:1:0 EndSectionBusID 需要根据lspci的实际输出填。这个配置的作用是告诉 Xorg 用哪个显示设备、哪个驱动。写错 BusID 会导致 X 起不来所以改之前先备份。5.3 分辨率与刷新率的手动指定有时候画面能出来但分辨率不对或者刷新率超出显示器支持范围导致黑屏。这种情况可以在内核参数里强制指定或者在 Xorg 配置里写死。我一般先用xrandr看看系统识别到了哪些模式和接口xrandr --query如果接口显示 disconnected 但显示器明明接着说明接口检测有问题可以尝试xrandr --output HDMI-1 --mode 1920x1080手动点亮。这个命令能临时验证接口是否可用可用的话再写进配置。6. 几个让我多花两小时的隐蔽坑6.1 内核更新后驱动模块丢失银河麒麟 V11 如果在线更新了内核新内核可能没有对应的集显驱动模块重启后直接黑屏。这个坑很隐蔽因为更新前一切正常。判断方法是看 GRUB 菜单里旧内核能不能正常进能进就是新内核缺模块。处理办法是进旧内核然后给新内核补装驱动包或者等厂商发布适配新内核的驱动。国产平台的驱动跟进速度有时候跟不上内核更新节奏所以生产环境我一般会锁定内核版本不轻易升级。6.2 双屏配置导致的输出错位接了双屏的情况下系统可能把主输出设到了你没注意的那个屏上。两个屏都黑的情况少见但一个亮一个黑很常见。这时候进系统如果有一个屏能亮用显示设置调整主屏或者拔掉一个屏再启动确认单屏正常后再接第二个。6.3 安全启动对驱动加载的拦截有些主板默认开启安全启动未签名的驱动模块会被拒绝加载导致集显驱动起不来。银河麒麟的官方驱动通常是签过名的但如果你自己编译或者从非官方渠道拿的驱动可能被拦。BIOS 里把安全启动关掉可以验证是不是这个原因。生产环境是否关闭安全启动要看具体安全要求验证阶段可以先关。6.4 显示器 EDID 读取失败个别显示器通过 HDMI 连接时 EDID 读取失败系统不知道显示器的支持模式干脆不输出。换一根线、换一个接口、或者换一台显示器试试能快速定位。也可以在 Xorg 配置里手动指定 EDID 文件绕过自动读取。7. 一套可复用的排查顺序与固化方案把上面的经验整理成一套顺序下次遇到同类问题可以直接照着走确认系统是否真的启动ping、键盘灯、SSH确认显示器接在哪个物理接口挨个试进 BIOS 把 Primary Display 改成 Onboard确认集显共享显存给够256M 以上GRUB 里临时加nomodeset验证是否驱动问题进系统后lsmod、dmesg确认驱动模块加载情况检查 Xorg 配置和显示管理器设置排查内核更新、安全启动、EDID 等隐蔽因素验证通过之后把临时改动固化BIOS 设置保存好内核参数写进/etc/default/grub然后update-grubXorg 配置放到/etc/X11/xorg.conf.d/下。固化完再完整重启两次确认稳定。我个人在实际操作中的体会是国产平台的显示问题八成出在输出通道和驱动加载这两件事上真正需要改代码或者等厂商修的情况很少。把 BIOS 和内核参数这两层吃透大部分黑屏都能自己解决。另外养成一个习惯每次动 BIOS 或者内核参数之前记下原始值出问题能快速回退这比事后回忆靠谱得多。