分区错位 · 坏块跳过不一致 · NAND 类器件量产排查手册

编制日期 2026-09-21 ｜ 版本号 Rev 1.0

XTX 芯天下 · FAE 现场技术文档 ｜ 面向 SPI NAND / PPI NAND（并行 NAND）/ SD NAND / eMMC 裸片量产烧录 ｜ 2026-09 版

一句话结论：「烧录通过但系统找不到数据 / 文件系统挂不上」几乎从不意味着芯片坏了。 它的本质是烧录器的裸片视角（烧什么地址 → 写什么内容）与系统驱动的运行视角 （哪个逻辑块号 → 哪个物理块号、ECC 由谁算）没有完全对齐。 烧录器的 Verify PASS 只证明「你让它写的字节，它读回来是一样的」——它既不认识你的分区表， 也不认识驱动里的 BBT 和 ECC 布局。

这份文档解决什么

解决的是 NAND 类器件（SPI NAND、PPI NAND、SD NAND、eMMC）在量产裸片烧录阶段， 校验 100% 通过、装板后却「找不到数据」或「文件系统挂不上」这一类问题的定位与根治方法。 全文把问题拆成三层、七个类目，每一类都按「机制 → 判据 → 立即动作 → 根治动作」四段给出。 第 10 章是可直接翻查的速查表，第 11 章是可带进车间的四方联合确认 SOP，第 12 章是可复制的清单与模板。

需要说清楚的是：本文档讨论的不是「坏块本身」，而是「两侧对坏块与分区的理解不一致」。 NAND 出厂自带坏块是行业常态，不是来料质量问题；把坏块当成故障去换料，只会让真正的不一致继续留在产线上。

怎么用这份文档

1. 先用可观测现象定层：能不能读到卷头 / Superblock、报不报 ECC 错误，据此落到第 2 章的三层之一，不要一上来就换芯片。
2. 在层内定位类目：第 3~9 章每章一类，每章开头都有「判据」，用判据筛掉不符合的类目，而不是逐个试。
3. 一次只改一个变量：分区偏移、坏块策略、ECC 配置每次只动一处，改完全片重烧、装板实跑，禁止叠加修改。
4. 两侧各导出一份证据再比对：烧录器侧的分区表与坏块清单、驱动侧的分区表与坏块清单，逐行 diff，不要靠记忆判断。
5. 用装板实跑闭环：任何配置变更，最终判定以「首件装板跑通 + 断电重启通过 + 抽检与首件一致」为准。

1. 问题本质：两套视角的不一致

分区错位与坏块跳过不一致，通常不是两个独立故障，而是同一件事的两个出口： 烧录器对这片介质的理解，与目标系统驱动对这片介质的理解，不是同一套。 本章先把两套视角并排放出来，再讲清楚为什么这两类问题会结伴出现、以及为什么它最容易被误判成器件不良。

1.1 共同根因：烧录器看物理，驱动看逻辑

烧录器在裸片状态下工作，它拿到的是一整片连续的物理地址空间，动作是「你把镜像给我、 告诉我写到哪个地址，我就写过去，遇到坏块按配置处理」。 系统驱动在运行时工作，它拿到的是逻辑块号，动作是「上层要第 N 个逻辑块， 我去查 BBT，把它映射到某个物理块，再用硬件 ECC 引擎校验」。

这两个视角各自都自洽，但它们的接口处没有任何强制校验——烧录器不认识驱动的分区表， 驱动也不知道烧录器跳过的是哪几个块。只要两侧的配置不是同一份，错位就必然发生，而且校验 100% 通过。

1.2 逐项对照：六个维度，每一个都可能错位

把两套视角拆成六个维度逐项对照，是定位问题的起点。现场绝大多数「说不清哪里错了」的案例， 都能在这张表里找到对应的那一行。

1.3 校验通过，到底证明了什么

这是全文最关键的一张表。烧录器的校验（Verify）本质是把写进去的内容读回来与源镜像逐字节比对， 它检验的是「数据搬运」这一件事；而系统能否找到数据、能否挂载，取决于驱动侧的「数据解释」规则。

1.4 为什么这两类问题总是一起出现

分区错位与坏块跳过不一致之所以高发合并出现，是因为它们之间有一条直接的因果链：

1. 烧录器跳过坏块 → 被跳过的块之后，所有内容在物理上整体后移；
2. 分区表的 offset 是按「没有坏块」算出来的 → 于是每个分区的物理起点都被推后了若干个块；
3. 驱动不知道烧录器跳过的是哪几个块 → 它只能按自己的 BBT 与分区表重新算一遍；
4. 两套算法的结果差若干个块 → 分区错位；同时逻辑块号映射到错误物理块 → 坏块跳过不一致；
5. 而这个差值随每一片的坏块分布不同而不同 → 同一工程下 A 片能起来、B 片起不来。

1.5 出厂坏块是行业常态，不是质量问题

这是本文档要纠正的第一个直觉。NAND 工艺决定了器件在出厂时就存在一定比例的坏块， datasheet 会给出出厂坏块数量上限与标记方式（具体数值与标记位置以 datasheet 为准）。 厂商在出厂前已完成标记与筛选，用户侧要做的不是「消灭坏块」，而是正确识别并一致地跳过。

2. 三层错位总览（决策树）

七个类目不是并列的七种故障，而是分布在三个层次上。 先定层、再定类，可以把排查路径从「七选一」缩短到「三选一，再三选一」。 本章给决策树与三层的对齐对象，后面七章每一章对应树上的一个叶子。

2.1 决策树：从现象到类目

树根是共同的现象——烧录通过，但系统找不到数据或挂不上。 往下分三条枝，分别对应三个层次；每条枝上是该层内的具体类目。 每个层面板底部有一块「判据」，先读判据：符合哪一块的判据，就进哪一层。

2.2 三层的对齐对象与拍板方

三层各自的对齐内容、配错后的暴露点、以及由谁拍板，都不一样。 这张表的用法是：先确定争议属于哪一层，再去找对应的责任方对齐， 不要跨层协商——跨层协商的典型结果是谁都觉得自己没错。

2.3 分层的三条纪律

• 先定层，再定类。跳过分层的直接后果是在七个类目之间反复横跳，每类都改一遍， 最后连原本能跑的配置也改坏了，现场再也回不到基线。
• 每层只认一份数据源。分区布局认分区表，坏块认坏块清单，ECC 认配置项； 三份都必须版本化归档，且烧录侧与驱动侧引用的是同一个文件、同一个版本。
• 改完必须回到基线上验证。任何一层的变更都要全片重烧 + 装板实跑， 禁止在「上一次改动还没验证」的状态上继续叠加第二次改动。

3. 第 1 类：分区表错位

分区表错位是三类分区问题里最基础的一类：烧录器按 A 表写，驱动按 B 表找，而 A 与 B 不是同一份。 它有三种典型形式——起点 offset 不一致、尺寸没对齐擦除块边界、单位混用。三者可以同时存在。

3.1 机制：写在哪与找在哪不是同一张表

烧录器工作时需要的只是「镜像文件 + 起始地址」，它不会去校验这张分区表是不是驱动要用的那张。 驱动侧的分区定义来自设备树、分区表分区（MBR / GPT）或内核命令行，同样不会去问烧录器。 两边各拿各的表，只要这两份表在某个边界上差了一点点，后续所有分区的物理位置就整体错位。

3.2 三种错位形式的对照

3.3 立即动作

1. 两侧各导出一份分区表，逐行 diff。烧录器侧从工程配置导出，驱动侧用 cat /proc/mtd 与设备树 / 分区定义交叉核对；两份表的字段必须能一一对应。
2. 统一到字节。把所有 start / size 换算成字节再比对，避免单位差异掩盖真实差异。
3. 把所有边界向上对齐到擦除块 / PEB 边界。这一步要按器件 datasheet 的块大小与平台 PEB 大小来算。
4. 确认分区表是同一份文件。固件侧与烧录侧必须引用同一个版本化文件，不允许各存各的副本。
5. 改完全片重烧，装板实跑验证。只看烧录器校验通过不算数。

3.4 分区表模板

第 12.2 节给了一份可直接复制的分区表模板，核心是强制用字节做单位、强制标注对齐基准、强制标注 ECC 与坏块策略三列。 把这三列写进模板，可以让「单位混用」这类错误在评审阶段就被拦住，而不是等到产线。

4. 第 2 类：分区内镜像偏移错位

分区起点对了，不代表镜像在分区内部的位置也对。 bootloader、kernel、fs 三段各有各的偏移来源，而且这些偏移是叠加的： 分区表给的起点只是一层，镜像自带的 header / 容器头是第二层，坏块跳过留出的空洞是第三层。

4.1 机制：偏移是三层叠加的

现场最常见的错误是只盯最终地址：把分区起点调来调去，试图用一个数把三层偏差全补回来。 这在某些片上能对上（因为那几片恰好没有坏块），换一片就失效——因为第三层偏差是逐片变化的， 而第一、二层是固定的，用一个固定数去补一个变量，必然只能对上一部分片子。

4.2 三段的偏移来源与判据

4.3 判据采集命令

下面这组命令的用途是把驱动侧认定的分区与偏移取出来，与烧录器工程里的配置逐项比对。 命令名与输出格式随平台与内核版本而变，以所用系统的实际输出为准。

# 驱动侧视角：把分区与偏移取出来（命令与输出以所用平台 / 内核版本为准）
cat /proc/mtd          # 驱动侧看到的分区起点与大小（十六进制字节）
cat /proc/partitions   # 块设备视角的分区（注意：单位是块，不是字节）
mtdinfo /dev/mtd2      # 该分区的擦除块大小、最小 IO 单位、OOB / spare 大小
ubinfo  /dev/ubi0      # UBI 视角：PEB / LEB 数量与大小、可用块数

# 烧录器侧视角：把工程里的分区表导出成同样的字段
# 重点核对三列，必须完全一致：
#     start(hex byte)      size(hex byte)      eraseblock / PEB size
# 任何一列不一致，先回第 3 章解决分区表，不要继续调镜像偏移

# 比对模板（两侧各存一份，用 diff 看差异）
diff prog_partition.txt  drv_partition.txt