Alibaba Cloud Linux 3 安装时无法识别NVMe SSD硬盘？

Question

在 Alibaba Cloud Linux 3 安装过程中，部分搭载较新 NVMe SSD（如 PCIe 5.0 或采用特定主控芯片的国产盘）的服务器可能出现硬盘无法识别的问题：安装界面中 `lsblk` 或 `nvme list` 无输出，Anaconda 安装器不显示目标磁盘，导致无法分区或安装系统。该问题通常源于内核模块缺失或固件兼容性不足——Alibaba Cloud Linux 3 默认内核（5.10.x）虽支持主流 NVMe 设备，但对部分厂商定制固件、未启用 `CONFIG_NVME_MULTIPATH`/`CONFIG_NVME_HWMON` 等可选驱动，或 BIOS 中 NVMe RAID 模式（如 Intel VMD 或 AMD fTPM 相关设置）未正确配置时，会导致设备枚举失败。此外，UEFI 启动模式下若 Secure Boot 强制签名验证，也可能阻止第三方 NVMe 驱动加载。建议检查 BIOS 中 NVMe 控制器模式（设为 AHCI 或 Native）、更新固件及内核微码，并在安装前通过 rescue 模式手动加载 `nvme_core` 和 `nvme` 模块验证识别状态。

Answer 1

```html

一、现象层：安装界面磁盘“消失”的直观表现

在 Alibaba Cloud Linux 3（内核 5.10.195-19.al8.x86_64）安装过程中，执行 lsblk 或 nvme list 命令返回空输出；Anaconda 图形/文本安装器的“安装目标”页面中无任何 NVMe 设备显示（如 /dev/nvme0n1）；dmesg | grep -i nvme 亦无设备探测日志。该现象非硬件故障，而是系统启动早期设备枚举阶段即已失败。

二、固件与平台层：BIOS/UEFI 配置的关键开关

• NVMe 控制器模式：必须设为 Native（非 RAID/VMD/fTPM 模式）；Intel 平台需禁用 Intel VMD Controller；AMD 平台需关闭 AMD fTPM 或启用 CSM Compatibility Mode（仅当必要时）
• Secure Boot：Alibaba Cloud Linux 3 安装镜像默认启用 UEFI Secure Boot，若厂商驱动未签名或内核模块被策略拦截，nvme_core 可能加载失败；建议临时 Disable 测试
• Firmware & Microcode：更新主板 BIOS 至最新版（尤其支持 PCIe 5.0 的厂商如 ASUS/ASRock/Insyde），同步更新 CPU 微码（intel-ucode 或 amd-ucode）

三、内核驱动层：模块依赖与编译配置深度解析

Alibaba Cloud Linux 3 内核虽启用 CONFIG_NVME_CORE=m 和 CONFIG_BLK_DEV_NVME=m，但以下可选配置缺失将导致特定主控异常：

配置项	作用	国产/PCIe 5.0 盘典型影响
CONFIG_NVME_MULTIPATH=y	支持多路径 NVMe（如长江存储致态 TiPlus7100 多队列仲裁）	单路径识别正常，但热插拔/重置后丢失
CONFIG_NVME_HWMON=y	启用温度/健康度传感器（部分国产量产固件强依赖此接口）	nvme list 无输出，dmesg 报 sensor read timeout

四、运行时验证层：Rescue 模式下的诊断链路

进入安装介质的 Rescue Mode 后，执行以下诊断流程（按序不可跳过）：

# 1. 确认基础模块未被黑名单
grep -r "blacklist nvme" /lib/modprobe.d/ /etc/modprobe.d/

# 2. 手动加载并强制探测
modprobe nvme_core && modprobe nvme && sleep 2
dmesg | tail -30 | grep -E "(nvme|PCI|ACPI)"

# 3. 若仍失败，尝试带参数加载（适配国产主控）
modprobe nvme_core default_ps_max_latency_us=5500
modprobe nvme

五、进阶修复层：定制 initramfs 与内核热补丁

对于已知兼容性问题型号（如联芸 MAP1202、英韧 IG5236 主控），推荐构建增强 initramfs：

1. 挂载安装镜像 ISO，提取 /isolinux/initrd.img
2. 使用 dracut --force --regenerate-all --kmod-blacklist=nouveau --force-drivers="nvme_core nvme" 重建 initramfs
3. 替换 ISO 中 initrd.img，并用 isomd5sum 重签校验和

六、生态协同层：厂商协同与上游反馈路径

当确认为内核主线尚未合入的补丁（如针对 Phison E26 PCIe 5.0 控制器的 nvme: add quirk for PS5026-E26），应同步执行：

• 向 Alibaba Cloud Kernel Team 提交 GitHub Issue（附 lspci -vvv -s $(lspci | grep NVMe | awk '{print $1}') 全量输出）
• 向 Linux NVMe Subsystem Maintainer（Keith Busch）提交补丁至 linux-nvme@lists/linux-nvme.org
• 同步向固件厂商索要符合 NVMe 2.0c 规范 的固件升级包

七、验证闭环层：自动化检测脚本（含 Mermaid 流程图）

部署以下 Bash 脚本于 Rescue 环境，实现一键诊断：

#!/bin/bash
echo "[+] Running NVMe readiness check..."
[ -f /proc/sys/kernel/kptr_restrict ] && echo 0 > /proc/sys/kernel/kptr_restrict
modprobe -r nvme{,_core} 2>/dev/null
modprobe nvme_core && modprobe nvme || { echo "FAIL: core load"; exit 1; }
if [ -c /dev/nvme0 ]; then
  echo "PASS: device node exists"
  nvme list 2>/dev/null | head -5
else
  echo "FAIL: no /dev/nvme0"
fi

graph TD
    A[启动 Rescue Mode] --> B[检查 Secure Boot 状态]
    B --> C{Secure Boot Enabled?}
    C -->|Yes| D[临时禁用并重启]
    C -->|No| E[加载 nvme_core + nvme]
    D --> E
    E --> F{dmesg 是否含 'nvme[0-9]: pci' ?}
    F -->|Yes| G[执行 nvme list]
    F -->|No| H[检查 BIOS NVMe 模式]
    G --> I{是否列出设备?}
    I -->|Yes| J[可安装]
    I -->|No| K[需加载 quirks 参数]

```