必须启用nvidia驱动内核级调试日志才能准确定位显卡驱动异常根本原因，方法是卸载后重载nvidia模块并传入nvreg_registrydwords等参数，再配合xorg logverbosity 6和nvidia-bug-report.sh综合分析三处日志。
在UOS系统中排查显卡驱动异常（如Xorg崩溃、登录循环、nvidia-smi无响应或日志中出现“NVRM”错误）时，必须开启驱动调试模式才能捕获内核级GPU模块的详细行为——不启用该模式，dmesg和/var/log/Xorg.0.log中仅显示“failed to load module”等模糊提示，无法定位nouveau冲突、PCIe链路异常或固件加载失败等根本原因。
启用NVIDIA驱动内核级调试日志
这一步直接向nvidia.ko模块注入调试开关，是获取GPU初始化全过程日志的唯一有效方式。
执行：sudo modprobe -r nvidia_uvm nvidia_drm nvidia && sudo modprobe nvidia NVreg_EnableGpuFirmware=1 NVreg_RmLogon=1 NVreg_RegistryDwords="RMDebug=0x10000000;Debug=0x10000000"
注意：命令中NVreg_RegistryDwords必须包含双引号包裹的完整键值对，漏掉引号会导致modprobe静默失败且不报错；若系统已加载nvidia模块，需先卸载再重载，否则新参数不生效。
验证是否生效：运行dmesg | grep -i "nvidia\|nvrm"，应看到大量以“NVRM: ”开头的行，包含GPU BIOS版本、PCIe link width、firmware loading status等字段。
配置Xorg服务器输出详细驱动日志
Xorg本身默认只记录严重错误，需强制其将nvidia_drv.so的每一步操作写入独立日志文件。
创建配置文件：sudo nano /etc/X11/xorg.conf.d/99-nvidia-debug.conf
写入以下内容：
Section "Device" Identifier "NVIDIA Card" Driver "nvidia" Option "LogVerbosity" "6" Option "UseEDID" "false"EndSection
【LogVerbosity 6是最高级别，会生成超大日志文件（单次启动可达50MB），务必在复现问题后立即关闭】。UseEDID设为false可排除显示器EDID解析失败导致的初始化挂起，这是UOS外接4K显示器黑屏的常见诱因。
重启显示服务：sudo systemctl restart lightdm（若lightdm未运行则用sudo systemctl restart gdm3）。
捕获并过滤关键调试信息
调试模式开启后，日志分散在三处，需按优先级顺序检查：
第一步：查看内核GPU模块日志 → dmesg -T | grep -A5 -B5 -i "nvidia\|nvrm\|drm"（-T显示本地时间，-A5/-B5各取上下5行便于定位上下文）
第二步：提取Xorg驱动层日志 → grep -n -A3 -B3 "NVIDIA\|Failed\|Error" /var/log/Xorg.0.log（重点看行号附近的“Loading extension”“Allocating framebuffer”等阶段）
第三步：检查用户空间工具日志 → nvidia-bug-report.sh --silent会自动生成/var/log/nvidia-bug-report.log.gz，解压后搜索“ERROR”“WARNING”“Timeout”关键词。
若在dmesg中发现“NVRM: GPU at 0000:01:00.0 has fallen off the bus”，说明PCIe物理链路中断，需检查BIOS中Above 4G Decoding是否启用、PCIe插槽供电是否稳定；此错误不会出现在Xorg日志中，仅靠nvidia-smi也无法捕获。
