PuppyIP 资源中心
网络与连接排错 10 分钟 发布于 2026-11-17

KWRT USB 与 NVMe 启动到错误 root:排查重复 PARTUUID 与 F2FS 扩容

KWRT 同时连接 USB 与 NVMe 克隆盘时,重复 PARTUUID 可能让启动选择不明确;先确认实际 root 设备,再单独评估分区与文件系统容量。

KWRT x86 PARTUUID 重复 USB 启动 NVMe F2FS OpenWrt 存储

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • PARTUUID 指向分区表中的分区标识,不等于 F2FS 文件系统 UUID,也不等于设备路径。
  • 从 /proc/cmdline、findmnt 和块设备信息确认系统实际使用哪个 root;不要仅凭启动盘名称推断。
  • 修改分区 GUID 或启动参数前需备份、确认 BIOS/bootloader 路径和救援介质,改错可能导致无法启动。
  • 分区扩展与 F2FS 文件系统扩展是两步;只有确认 root 设备及分区布局后才选择对应工具。

区分 PARTUUID、文件系统 UUID 和 root 设备

x86 路由器同时接入 USB 启动盘和 NVMe 克隆盘时,如果分区表保留了相同 PARTUUID,启动参数可能无法唯一选中 root 分区。系统最终挂载哪个设备还取决于固件启动顺序、内核命令行、分区枚举和 overlay 配置;磁盘显示为 USB 或 NVMe 并不代表 root 已从该盘启动。

PARTUUID 是分区表中分区的标识,文件系统 UUID 由文件系统自身保存,两者用途不同。调整文件系统 UUID 不一定会修复重复 PARTUUID。先收集设备、分区、挂载来源和启动参数,再决定是否需要改唯一标识、bootloader 指向或扩容。

只读确认当前 root 来自哪里

在本机控制台或仍可用的 SSH 会话中读取内核命令行、挂载来源和块设备标识。对照 /proc/cmdline 中的 root 参数与 findmnt、lsblk、blkid 的结果,确认实际根分区、启动分区和 overlay/data 分区分别位于哪块盘。如果工具没有显示 PARTUUID,使用已安装的只读分区信息工具,不要为此安装或修改磁盘。

在做任何写入前保存输出并确认设备序列号或物理插槽对应关系,但不要在公开文稿、截图或工单中发布真实序列号、WWN、MAC 或私有设备路径。以下命令只读取当前设备状态。

读取启动参数、挂载和磁盘标识

sh
cat /proc/cmdline
findmnt -no SOURCE,FSTYPE,OPTIONS /
lsblk -o NAME,TYPE,FSTYPE,SIZE,PARTUUID,UUID,MOUNTPOINTS
blkid
在本机控制台只读确认 root 来源、文件系统与分区标识。分享前移除硬件序列号、WWN、真实挂载路径和其他设备身份信息。

安全处理重复 PARTUUID 与启动目标

若两块盘确有重复 PARTUUID,先确认当前启动链由 BIOS、GRUB、Syslinux、extlinux 还是设备固件配置管理,并找出内核实际读取的 root= 参数。选择保留的启动盘和目标 root 后,再由对应分区工具为另一块盘生成唯一分区 GUID,或更新 bootloader 指向;这两个操作必须配套,不能只改一边。分区 GUID 的修改会影响所有引用旧标识的启动项。

操作前先制作整盘或分区镜像、备份启动配置并准备可启动救援介质。只有确认设备型号、分区表类型、目标分区和启动配置后才执行相应工具;不同分区表与启动管理方式没有安全通用的一条改写命令。若不确定当前 bootloader 或新 GUID 没有写入启动配置,停止并由熟悉该镜像的维护者核验。

分区扩展与 F2FS 扩展要分开验证

克隆盘的分区可能仍保持原始小尺寸,即使 NVMe 容量更大;文件系统不会仅因磁盘变大就自动占用全部空间。先用块设备布局确认 root 所在分区以及其后是否有未分配空间,再根据具体分区表工具扩展分区边界。扩展分区会改变磁盘元数据,必须先有可恢复备份并确认操作对象。

分区扩大后,才按当前内核、F2FS 工具和挂载状态支持的方式扩展文件系统。不要把 F2FS 文件系统操作套用到 ext4 或只读 SquashFS root;不要在尚未确认目标分区时运行格式化、修复或 resize 命令。分区空间与 df 显示的文件系统空间应分别检查。

重启前后核对启动结果和可用容量

若完成了标识或分区变更,先在救援系统中复核 GUID 唯一、bootloader 指向目标 root、启动配置已写入并且备份可读取。之后安排本地维护窗口重启,启动后重新检查 /proc/cmdline、root 挂载源、overlay 来源、分区标识和 df 输出。确认两块盘仍可被正确区分,系统没有意外从旧 USB 盘启动。

业务验证要单独记录启动稳定性、根分区可用空间和路由器服务状态。仅看到 lsblk 中分区变大,不代表 F2FS 文件系统已经扩容;仅看到 df 变化,也不能证明下次重启会从预期盘启动。

回滚和设备限制

如果重启后无法挂载 root,使用救援介质恢复备份的分区表和 bootloader 配置;不要在数据盘上继续尝试多个分区 ID。改过 GUID 后,可能需要同步恢复所有引用它的启动项。确认文件系统元数据风险前,不要执行自动修复或重新格式化。

设备型号、BIOS/bootloader、分区表、overlay 布局和 OpenWrt/KWRT 镜像都会改变流程。MIPS 设备、不同 x86 镜像和外接盘布局不能直接套用同一操作。无法确认实际启动源时,先保留只读诊断结果;任何修改分区标识或扩展 root 都需要本地恢复能力。

资料来源

常见问题

PARTUUID 和 F2FS UUID 是一回事吗?

不是。PARTUUID 是分区表标识,UUID 是文件系统标识。先查清启动参数引用的是哪一个。

NVMe 容量大于 USB 盘,root 会自动扩容吗?

不一定。克隆分区可能仍是原尺寸,还需分别扩展分区边界和文件系统,并检查 df 结果。

可以直接修改 PARTUUID 后重启吗?

不要只改分区标识。必须确认 bootloader 与 root= 参数是否引用旧值,并准备备份和本地救援介质。

怎样确定当前系统从哪块盘运行?

对照 /proc/cmdline、findmnt、lsblk 和 blkid 的挂载来源与分区标识;不要仅凭设备名称判断。