一、故障现象有一台使用铭瑄 H610 主板的台式机安装 Ubuntu 22.04 后系统设置中看不到板载有线网络主板网口无法正常联网。二、系统环境执行以下命令查看内核版本uname-a返回Linux fa-desktop5.19.0-32-generic#33~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Mon Jan 30 17:03:34 UTC 2 x86_64 x86_64 x86_64 GNU/Linux系统环境为Ubuntu 22.04 Kernel: 5.19.0-32-generic 主板铭瑄 H610 板载有线网卡Realtek RTL8111/8168/8411 PCIe Gigabit Ethernet三、排查过程1. 使用 usb 转网口或者 usb 共享网络保证主机能正常上网2. 检查 PCIe 层是否能枚举到板载网卡先确认系统是否能在 PCIe 层识别到板载有线网卡。执行lspci-nnk|grep-A4-Eiethernet|network现场返回03:00.0 Ethernet controller[0200]: Realtek Semiconductor Co., Ltd. RTL8111/8168/8411 PCI Express Gigabit Ethernet Controller[10ec:8168](rev 2b)Subsystem: Realtek Semiconductor Co., Ltd. RTL8111/8168/8411 PCI Express Gigabit Ethernet Controller[10ec:0123]Kernel modules: r8169 04:00.0 Network controller[0280]: Realtek Semiconductor Co., Ltd. Device[10ec:b852]Subsystem: Realtek Semiconductor Co., Ltd. Device[10ec:b852]这里有两个关键点。第一系统能看到板载有线网卡Realtek RTL8111/8168/8411 PCI Express Gigabit Ethernet Controller [10ec:8168]这说明板载网卡已经被 PCIe 总线枚举到问题不是“系统完全看不到硬件”。第二输出中只有Kernel modules: r8169但没有Kernel driver in use: r8169这说明系统知道该设备可能使用r8169模块但当前没有实际绑定成功。正常情况下如果驱动已经成功绑定lspci -nnk通常应看到类似Kernel driver in use: r8169 Kernel modules: r8169或者在安装 Realtek 专用驱动后看到Kernel driver in use: r8168 Kernel modules: r8168本次现场没有Kernel driver in use这是判断驱动未绑定的关键证据。2. 检查系统是否生成网络接口执行ip-brlink现场返回lo UNKNOWN 00:00:00:00:00:00LOOPBACK,UP,LOWER_UPenx70198877aa31 UP70:19:88:77:aa:31BROADCAST,MULTICAST,UP,LOWER_UP这里只看到enx70198877aa31该接口为 USB 有线网卡。没有看到板载网卡常见接口名例如enp3s0 eno1这说明板载 Realtek 网卡虽然被 PCIe 枚举到但系统没有为它生成网络接口。3. 检查 NetworkManager 设备状态执行nmcli device status现场返回DEVICE TYPE STATE CONNECTION enx70198877aa31 ethernet 已连接 以太网连接1lo loopback 未托管 --NetworkManager 只识别到 USB 网卡没有识别到板载有线网卡。四、根因判断本次故障根因为Ubuntu 22.04 当前内核环境下铭瑄 H610 主板板载 Realtek RTL8111/8168/8411 有线网卡未成功绑定驱动导致系统没有生成板载有线网络接口。证据链如下lspci可以看到 Realtek RTL8111/8168/8411 网卡说明 PCIe 层面已经识别到硬件lspci -nnk中只有Kernel modules: r8169没有Kernel driver in useip -br link中没有生成板载网卡接口nmcli device status中没有板载有线网卡USB 网卡可正常联网说明系统基础网络功能正常处理后安装r8168-dkms并重启板载有线网卡恢复。五、处理方案因为现场已经通过 USB 有线网卡联网可以直接通过 apt 安装 Realtek 专用驱动。执行以下命令sudoaptupdatesudoaptinstall-yr8168-dkms linux-firmwaresudoreboot命令说明sudoaptupdate更新软件源索引。sudoaptinstall-yr8168-dkms linux-firmware安装 Realtek RTL8111/RTL8168 系列常用的r8168-dkms驱动并同时更新linux-firmware固件包。sudoreboot重启系统使 DKMS 驱动完成加载并重新绑定网卡。六、处理结果现场执行以下三行命令后问题解决sudoaptupdatesudoaptinstall-yr8168-dkms linux-firmwaresudoreboot重启后Ubuntu 可以正常识别铭瑄 H610 主板板载有线网卡系统设置中恢复有线网络选项主板网口可以正常使用。七、适用场景该处理方法适用于以下类似场景Ubuntu 22.04 安装后看不到板载有线网卡主板为 H610 / B660 / B760 等消费级主板有线网卡为 Realtek RTL8111 / RTL8168 / RTL8411lspci可以看到网卡ip link看不到板载网口nmcli device status看不到板载网卡lspci -nnk中只有Kernel modules没有Kernel driver in use临时接 USB 网卡后可以联网。