我玩STM32这几年，W25Q128基本是绕不开的一个片子。不管是做数据记录仪、GUI缓存的图片字库，还是OTA固件备份，这颗128Mbit的SPI NOR Flash可以说是性价比极高的选择。但很多朋友一开始都是拿GPIO模拟SPI去驱动它，慢不说，还容易在时序上踩坑。这次我直接把实际项目中验证过的方案分享出来：基于STM32硬件SPI外设，从CubeMX图形化配置到DMA高速读写，整个过程完整走一遍，最后附上可以直接套用的代码。
这篇文章适合正在用F1/F4/G0系列做产品开发、或者刚接触SPI Flash想搞清楚硬件SPI和DMA配合逻辑的朋友。你会搞清楚几个关键问题：为什么CubeMX里SPI参数要那样填、DMA的Normal和Circular模式到底选哪个、W25Q128的读和写为什么在时序上完全不同。读完你就能从CubeMX生成工程，到自己写驱动，再到用DMA把读取速率拉满，整个过程不会有那种“教程能跑但换成自己的板子就废”的割裂感。
1. 整体方案拆解：为什么是硬件SPI加DMA，而不是模拟时序
1.1 软件模拟SPI和硬件SPI的本质差异
先说个很多新手容易忽略的问题：SPI通信本身并不复杂，就是四根线（CLK、MOSI、MISO、CS），按时钟节奏一位一位往外送数据。用GPIO模拟SPI完全可行，甚至网上很多例程都这么干。但模拟SPI的性能瓶颈在于：每个bit都要CPU去翻转电平、读电平，一个字节8个bit，再加上延时和循环，CPU几乎被占满。
以W25Q128为例，它支持最高104MHz的时钟频率。如果主频72MHz的STM32F103用GPIO模拟，能把SPI时钟跑到1-2MHz就已经很吃力了，再高就会出现波形畸变、采样错位。而硬件SPI外设是芯片内部专门为串行通信设计的电路，只要配置好分频系数，它自己就能产生精确的时钟波形，CPU只需要把数据丢给数据寄存器就行。
对于W25Q128这种大容量Flash来说，动不动就要读写几十KB甚至几MB的数据，用软件模拟SPI去传，一次固件升级能等得人怀疑人生。硬件SPI加上DMA之后，数据传输完全不用CPU干预，CPU可以腾出手去做别的事情,比如刷新LCD、处理按键扫描、跑通信协议栈。这也是为什么产品级的代码里几乎没人用GPIO模拟SPI去驱动W25Q128。
1.2 W25Q128内部结构对驱动设计的影响
W25Q128的容量是128Mbit，换算过来是16MByte，分成256个64KB的Block，每个Block又分成16个4KB的Sector，最小的擦除单位是4KB的Sector，最小的编程单位是1Byte，但实际上按Page（256Byte）编程效率最高。
这个结构决定了驱动设计上的几个要点。第一，写数据之前必须先擦除，而且擦除是按Sector/Block/整片三种粒度进行的。第二，擦除操作非常耗时：擦除一个Sector大概要150ms（典型值），擦除一个Block要1秒左右，整片擦除更是要40到160秒。第三，Flash的写入不是随便写的，只能把1写成0，要把0恢复成1只能靠擦除。这意味着如果你的应用程序要频繁更新小数据，必须设计好磨损均衡策略，不能每次都擦同一个Sector，否则这颗芯片的10万次擦写寿命很快就会被耗尽。
还有一个容易踩坑的点：W25Q128上电默认是读不了数据的。它上电后处于power-down状态或者标准SPI模式，但这不代表CS一拉低就能读ID。必须发送0x9F（Read JEDEC ID）指令，芯片才会把制造商ID和设备ID返回给你。如果读到ID不对，后面所有操作都是空中楼阁。
1.3 DMA参与后系统架构的变化
加入DMA之后，整个数据通路就变了。传统模式下，CPU把数据逐个写入SPI->DR寄存器，读的时候又逐个从SPI->DR读取，每个字节都要经历“判断发送寄存器空”、“判断接收寄存器非空”这两个标志位的轮询。一个字节还好，几万个字节下来，CPU时间全耗在等待上了。
DMA模式下，CPU只需要做三件事：启动DMA传输、等待DMA传输完成中断、处理接收缓冲区里的数据。以读取W25Q128的8KB数据为例，传统轮询方式下，CPU全程被占用，期间不能响应其他中断，这在实时性要求高的系统里几乎是灾难。而DMA方式下，CPU启动传输后就可以干别的，等DMA把数据全部搬完再通知你。
不过这也会带来一个新的问题：DMA和CPU谁先访问内存？如果DMA正在往内存搬运数据，CPU同时又去读同一个缓冲区，就会发生总线竞争。好在STM32的DMA控制器和内核之间有仲裁机制，但为了稳妥起见，我还是建议读取操作使用双缓冲或者等待DMA传输完成标志后再处理数据。后面代码部分会展示这种安全处理方式。
2. CubeMX配置一步步来：从新建工程到SPI参数全解
2.1 新建工程与时钟树设置
CubeMX配置的第一步是选择芯片型号。我用的是STM32F103RCT6，64pin封装，Flash是256KB，RAM是48KB。这个芯片在项目里非常常见，淘宝上几块钱一片，做产品样机足够了。如果你是F407或者G030之类的芯片，配置思路完全一样，只是DMA通道号和中断号要按参考手册对应。
时钟树的部分，我直接把HSE设为8MHz外部晶振，主频拉满到72MHz。SPI1挂在APB2总线上，APB2的最高频率就是72MHz，所以SPI1的时钟源也是72MHz。这里有个常识：STM32F103的SPI1和SPI2挂在不同的总线上，SPI1在APB2（72MHz），SPI2在APB1（36MHz）。同样的分频系数下，SPI1能跑到的最高时钟就是SPI2的两倍，所以高速读写W25Q128，优先选择SPI1。
时钟树配置里还要注意一个坑：如果你把APB2的分频器配置成了2分频，那SPI1的时钟源就只有36MHz了。CubeMX里有个“Reset Configuration”按钮，点一下就会全部打回默认状态，重新配PLL和分频，避免因为之前的配置残留导致SPI频率不对。
2.2 SPI参数面板的每一项怎么填
进入SPI1的参数配置界面，有这几个关键参数需要逐个说清楚：
第一个是Frame Format，选Motorola模式，也就是最经典的SPI Mode 0到Mode 3。W25Q128的数据手册明确写了支持SPI Mode 0（CPOL=0，CPHA=0）和Mode 3（CPOL=1，CPHA=1）。我习惯用Mode 0，也就是空闲时钟为低电平，数据在第一个时钟沿采样。这个模式下，时钟空闲是低，发送方在时钟上升沿把数据送出去，接收方在上升沿采样。CubeMX里对应设置就是Clock Polarity（CPOL）为Low，Clock Phase（CPHA）为1 Edge。
第二个关键参数是Data Size，选8bit。W25Q128的一条指令有8位指令码、24位地址、后续数据，本质上都是字节。虽然它支持Quad模式（四线IO），但普通SPI操作下就是8位一个单位。
第三个是First Bit，选MSB First。W25Q128的所有指令都是高位先发，这个一定不能选错，选成LSB First的话，ID读出来都是字节颠倒的，数据写入后读出来也是乱的。
第四个是Prescaler（分频系数）。SPI1的输入时钟是72MHz，目标是让SCLK频率尽量高但不能超过W25Q128的极限104MHz。我把分频系数设为2，也就是SPI时钟跑到36MHz。这个频率已经在安全范围内，而且比很多开发板标称的18MHz要快不少。如果需要更保守的验证环境，可以设为4，也就是18MHz。实测下来，短走线（5cm以内）的杜邦线连接，36MHz跑读写没问题；如果飞线很长或者用了面包板，建议降到18MHz，否则波形质量会比较差。
最后一个比较容易被忽略的是NSS（片选）设置。CubeMX里默认可能把NSS配置为Hardware Mode，但这样的话片选信号由硬件自动控制，每次传输前硬件会自动拉低CS，传输完自动拉高。问题在于，W25Q128的很多操作（比如写状态寄存器）需要持续拉低CS来保持通信会话，硬件自动控制的话，时序对不上会导致指令执行失败。
我在实际项目里用的是软件控制CS，也就是把NSS引脚配置成普通GPIO输出，手动拉低和拉高。虽然CubeMX的硬件NSS也能用软件去干预，但用GPIO控制会简单直观很多，调试起来也方便。后面代码里会看到SS_GPIO_Port和CS_Pin的宏定义。
2.3 DMA通道配置的几个关键点
CubeMX配置DMA这一步，我见过不少朋友卡在这里。通道（Channel）和请求（Request）的概念要先搞清楚。
F103的SPI1_TX和SPI1_RX分别占用DMA1的不同通道。CubeMX里你只需要选择SPI1_TX，然后它默认会指向DMA1 Channel 3，SPI1_RX指向DMA1 Channel 2。在代码里你会看到类似于hspi1.hdmatx = &hdma_spi1_tx这样的赋值，这个关联就是CubeMX自动生成的。
DMA的两个核心参数是Direction和Mode。Direction选择Memory To Peripheral（发送）或Peripheral To Memory（接收）。Mode这里有两种：Normal和Circular。驱动W25Q128这种一次性读取固定长度数据的场景，用Normal就够了，也就是DMA传输完指定长度后自动停止。Circular模式适用于持续不断的数据流，比如ADC连续采样输出，SPI Flash的读写很少用到。
还有Priority DMA优先级，我一般设成High，因为SPI数据传输如果被打断，可能导致帧同步错误。当然这不是绝对的，如果你的系统里还有UART、USB等高速外设，可以根据实际需求调整。CubeMX里设置好后，生成代码时会自动把DMA初始化函数放在MX_DMA_Init()里，注意这个函数会被main()中的HAL_Init()之后调用，不要自己手动注释掉。
注意：生成代码后，
MX_DMA_Init()必须在MX_SPI1_Init()之前调用，否则DMA和SPI的关联不会生效。CubeMX默认排列顺序就是这样，但如果你手动调整过初始化顺序，务必检查这一点。
3. 驱动代码实现：从底层读写函数到DMA高速版本
3.1 硬件SPI底层接口封装
CubeMX生成的HAL库代码里，SPI的收发有几个现成函数：HAL_SPI_Transmit()、HAL_SPI_Receive()、HAL_SPI_TransmitReceive()，还有它们的中断和DMA版本。对于W25Q128的操作，我封装了三个核心接口：SPI读写一个字节、SPI写入一段数据、SPI读取一段数据。
先看最基础的读写一个字节的函数：
uint8_t SPI_ExchangeByte(uint8_t byte) { uint8_t rxdata; HAL_SPI_TransmitReceive(&hspi1, &byte, &rxdata, 1, 100); return rxdata; }这个函数内部调用的是HAL_SPI_TransmitReceive()，它同时发送一个字节并接收一个字节，正好适合SPI全双工的特性。发送和接收在同一个时钟周期内完成。这个函数的超时时间我设成了100ms，正常情况下一个字节的SPI传输是微秒级的，100ms完全够，但出现异常时又能及时退出，不会卡死系统。
再来是读取一段数据到缓冲区。这里有个关键点：SPI读取数据时，主机必须持续发送时钟。所以读操作的实现一般是先发送一个任意字节（通常是0x00或0xFF）来产生时钟，同时把从机返回的数据收进来。我封装了一个函数：
void SPI_ReadBuffer(uint8_t *pBuffer, uint16_t len) { HAL_SPI_Receive(&hspi1, pBuffer, len, 1000); }HAL库的HAL_SPI_Receive()在硬件上会自动处理时钟生成，不需要你手动发送哑字节。但要注意，这个函数只负责纯接收场景，如果你的代码里先调用了HAL_SPI_Transmit()发送指令，紧接着又要HAL_SPI_Receive()读取响应，中间CS必须一直是低电平，否则W25Q128会认为一次命令结束了。
3.2 W25Q128的指令集与关键寄存器操作
W25Q128最核心的指令无非那么几条：读ID（0x9F）、写使能（0x06）、读状态寄存器（0x05）、页编程（0x02）、扇区擦除（0x20）、读数据（0x03）。
读ID是上电后第一个要做的验证操作：
uint16_t W25Q_ReadID(void) { uint16_t id = 0; uint8_t d1, d2; CS_LOW(); SPI_ExchangeByte(0x9F); // Read JEDEC ID指令 d1 = SPI_ExchangeByte(0xFF); // 制造商标识 d2 = SPI_ExchangeByte(0xFF); // 设备标识 CS_HIGH(); id = (d1 << 8) | d2; return id; }W25Q128的JEDEC ID是0xEF 0x40 0x18，其中制造商ID是0xEF（Winbond），设备ID的两个字节分别是0x40和0x18。所以读出来的16位应该是0x4018。实际调试时，经常有人读到0xFFFF或者0x0000，那基本就是接线问题或者SPI配置问题，而不是芯片坏了。这块我在后面的问题排查里详细说。
写使能是写入操作的前提。因为Flash芯片内部有个写使能锁存器，每次写操作之前必须发送0x06指令把锁存器置位：
void W25Q_WriteEnable(void) { CS_LOW(); SPI_ExchangeByte(0x06); CS_HIGH(); }写状态寄存器（0x01）和读状态寄存器（0x05）也很常用。擦除和编程都是异步操作，芯片在执行的时候忙标志位（BUSY）会置1，你需要轮询状态寄存器的bit0来判断是否完成：
void W25Q_WaitBusy(void) { uint8_t status; CS_LOW(); SPI_ExchangeByte(0x05); do { status = SPI_ExchangeByte(0xFF); } while (status & 0x01); CS_HIGH(); }注意，等待忙状态时，CS必须保持低电平。有些新手在循环里反复拉高拉低CS，每次重新发送0x05指令，也能工作，但效率会低一些。
3.3 读写擦除三大核心函数实现
读数据是最常用的操作。W25Q128的0x03指令是普通读模式，最快支持到50MHz时钟。后面跟24位地址，然后芯片就会持续把该地址开始的数据从MISO输出，只要CS保持低，可以连续读任意多字节，读到Flash末尾会自动回卷到0地址：
void W25Q_Read(uint32_t addr, uint8_t *pData, uint32_t len) { uint32_t i; CS_LOW(); SPI_ExchangeByte(0x03); SPI_ExchangeByte((uint8_t)(addr >> 16)); SPI_ExchangeByte((uint8_t)(addr >> 8)); SPI_ExchangeByte((uint8_t)(addr)); for (i = 0; i < len; i++) { pData[i] = SPI_ExchangeByte(0xFF); } CS_HIGH(); }页编程要小心一点。0x02指令后面跟24位地址，然后是要写入的数据。一次最多写256个字节，这个256字节必须限制在一个Page内，也就是说，如果起始地址不是Page对齐的，写入长度超过256字节，就会写到当前页的边界后自动回卷到该页开头，导致数据覆盖。正确做法是判断剩余字节数和当前页剩余空间，分段写入：
void W25Q_WritePage(uint32_t addr, const uint8_t *pData, uint32_t len) { uint32_t i; W25Q_WriteEnable(); CS_LOW(); SPI_ExchangeByte(0x02); SPI_ExchangeByte((uint8_t)(addr >> 16)); SPI_ExchangeByte((uint8_t)(addr >> 8)); SPI_ExchangeByte((uint8_t)(addr)); for (i = 0; i < len; i++) { SPI_ExchangeByte(pData[i]); } CS_HIGH(); W25Q_WaitBusy(); }扇区擦除是最常用的擦除粒度。4KB的Sector擦除后全部变成0xFF。擦除之前同样要先发写使能，然后发0x20指令和24位地址。Sector地址必须是4KB对齐，也就是地址的低12位必须是0：
void W25Q_EraseSector(uint32_t sector_addr) { W25Q_WriteEnable(); CS_LOW(); SPI_ExchangeByte(0x20); SPI_ExchangeByte((uint8_t)(sector_addr >> 16)); SPI_ExchangeByte((uint8_t)(sector_addr >> 8)); SPI_ExchangeByte((uint8_t)(sector_addr)); CS_HIGH(); W25Q_WaitBusy(); }3.4 DMA版本的高效读写
接下来是重头戏：DMA版本的读写函数。DMA模式下，数据不再通过CPU逐字节搬运，而是由DMA控制器直接完成SPI外设和内存之间的传输。对于发送方向，你要做的就是先把数据准备好，然后调用HAL_SPI_Transmit_DMA()，DMA会把内存缓冲区里的数据搬到SPI的发送寄存器；对于接收方向，调用HAL_SPI_Receive_DMA()，DMA会把SPI的接收寄存器里的数据搬到内存缓冲区。
不过这里有个小坑：W25Q128的读操作需要先发送指令和地址，然后才能读数据。所以DMA读数据其实是分两个阶段。第一阶段用普通的轮询或DMA发送指令，第二阶段再用DMA接收数据。如果你的DMA接收用了Normal模式，一次传输完指定长度后DMA会自动停止，这是对的。但注意，在调用DMA接收之前，CS必须保持低电平，不能让W25Q128认为指令会话结束了。
下面是DMA版本的关键代码：
void W25Q_Read_DMA(uint32_t addr, uint8_t *pData, uint32_t len) { uint8_t cmd[4]; cmd[0] = 0x03; cmd[1] = (uint8_t)(addr >> 16); cmd[2] = (uint8_t)(addr >> 8); cmd[3] = (uint8_t)(addr); CS_LOW(); HAL_SPI_Transmit(&hspi1, cmd, 4, 100); HAL_SPI_Receive_DMA(&hspi1, pData, len); // 必须等DMA传输完成，否则CS拉高太快，数据没拿完 while (HAL_SPI_GetState(&hspi1) != HAL_SPI_STATE_READY); CS_HIGH(); }HAL_SPI_GetState()返回HAL_SPI_STATE_READY时，说明DMA传输已经完成，SPI外设空闲了。这个等待逻辑比较粗暴，但配合DMA传输完成中断其实是更好的方式。在中断回调里置一个标志位，主循环判断标志位再拉高CS，这样不会阻塞CPU。
DMA写的思路类似，命令和地址还是要先发，然后数据部分用DMA发送。但要注意，W25Q128的页编程一次最多256字节，DMA发送也一样，超过256字节就得拆分：
void W25Q_Write_DMA(uint32_t addr, const uint8_t *pData, uint32_t len) { while (len > 0) { uint16_t chunk = (len > 256) ? 256 : len; // 检查跨页边界，如果剩余字节数超过当前页末尾，就截断 uint16_t page_remain = 256 - (addr % 256); if (chunk > page_remain) { chunk = page_remain; } uint8_t cmd[4]; cmd[0] = 0x02; cmd[1] = (uint8_t)(addr >> 16); cmd[2] = (uint8_t)(addr >> 8); cmd[3] = (uint8_t)(addr); W25Q_WriteEnable(); CS_LOW(); HAL_SPI_Transmit(&hspi1, cmd, 4, 100); HAL_SPI_Transmit_DMA(&hspi1, (uint8_t *)pData, chunk); while (HAL_SPI_GetState(&hspi1) != HAL_SPI_STATE_READY); CS_HIGH(); W25Q_WaitBusy(); addr += chunk; pData += chunk; len -= chunk; } }页对齐这个计算是必须的。假设addr是300，那么当前页剩余空间就是256 - (300 % 256) = 256 - 44 = 212字节。如果你一次要写300字节，第一段只写212字节，写完地址变成512，正好是下一页的起始地址，第二段再写88字节。这样就能避免跨页回卷导致的数据灾难。
3.5 擦除的粒度选择对产品寿命的影响
擦除效率直接影响到Flash的寿命和使用体验。W25Q128支持三种擦除方式：4KB Sector擦除、32KB Block擦除、64KB Block擦除、整片擦除。整片擦除最慢，但一次性清空所有数据很方便；Sector擦除最灵活，适合频繁更新的小数据存储。
实际项目中，我总结出的经验是：频繁更新的小数据，用Sector擦除，比如存储设备运行参数、WiFi配置信息，每4KB一个槽位，轮询使用；中等大小的数据，比如OTA固件包，可以按64KB Block擦除，减少擦除指令的次数，因为每次发擦除命令前都要等上一次擦除完成。如果一块固件有512KB，用Sector擦除要发128次命令，用64KB Block擦除只需要8次，省下的时间还是很可观的。
4. 实测性能表现与常见问题排查
4.1 DMA高速读写的实测数据
我用逻辑分析仪抓过波形，也用了HAL_GetTick()做过毫秒级计时。在SPI时钟36MHz、开启DMA的条件下，实测读取1MB数据大概耗时约290ms左右，换算下来读取速率在3.5MB/s。这个速度和W25Q128理论上限还有差距，因为W25Q128在标准SPI模式下，每8位数据需要至少8个时钟周期，36MHz时钟理论上是4.5MB/s，考虑到指令地址和命令开销，实测3.5MB/s已经很接近极限了。
页编程的速度会慢很多，因为每写一页（256字节），芯片内部都需要程序化时间，典型值在0.7ms到3ms之间，这部分是芯片物理特性决定的，不管SPI时钟多快都没用。实测连续写1MB数据，耗时大约在3到4秒，平局速率0.3MB/s左右。
如果你需要更高的读速度，可以开启W25Q128的快速读模式（0x0B指令），这个支持到104MHz时钟，但前提是你的STM32 SPI时钟能跑到那么高。F103的SPI1最高36MHz（72MHz主频2分频），F4系列SPI可以跑到45MHz左右，再往上就受限了。所以对于F1平台来说，36MHz是性价比最高的档位，没必要牺牲稳定性追更高频率。
4.2 常见故障：读ID不对、一直忙、数据错乱
读ID不对是玩W25Q128最高频的问题。ID读出来是0xFFFFFF或者0x000000，大概率是硬件连接问题。排查顺序是这样的：先量VCC和GND，确保供电正常，W25Q128的工作电压是2.7V到3.6V，3.3V供电没问题；然后查CS、CLK、MOSI、MISO四根线有没有接反，尤其是MOSI和MISO，接反了数据完全不通；再用示波器或者逻辑分析仪看SPI时钟波形，确认主控侧确实有时钟输出。
软件方面，检查SPI的CPOL和CPHA是否配置正确。W25Q128的Mode 0对应CPOL=0、CPHA=0，意思是空闲时CLK为低，数据在第一个时钟沿采样。CubeMX配置界面里，把Clock Polarity选为Low，Clock Phase选为1 Edge，就是你想要的Mode 0。
第二种常见问题是指令发出去后，读取状态寄存器一直显示忙（BUSY位一直为1）。这个问题大多是CS时序不对导致的。擦除或编程过程中，CS应该保持高电平让芯片内部操作，但如果你在等待忙的过程中不小心拉低了CS又拉高了，芯片可能会误判为一次新的指令开始，导致状态混乱，一直卡在忙状态出不来。解决方法是严格按照长度操作，等待忙状态时CS保持低并轮询，或者用延时函数先等一段时间再查忙。
第三种问题比较隐蔽，就是写入的数据读出来是错误的，最常见的是数据错位几个字节。这个大概率是SPI帧格式或者数据大小配置错了。Data Size一定要是8bit，First Bit一定要是MSB。还有一个容易被忽略的点：如果你用了DMA发送数据，发送缓冲区的数据格式和被DMA搬移的字节顺序，在Cortex-M3这样的平台上是小端模式，和SPI的MSB-first顺序没有任何冲突，但如果你的数据是多字节变量（比如uint16_t或uint32_t数组），要注意字节序问题，发送前把数据转换成字节流。
4.3 一个调试小技巧：错误注入法
这个方法是我在实际项目里摸索出来的，排查问题时特别好用。那就是故意写错一个的关键参数，观察故障现象，如果现象和你预期的错误类型吻合，说明系统链路是通的，问题出在软件参数上；如果现象完全不对，那大概率是硬件或者初始化的问题。
举个例子，调试的时候把CPOL从Low改成High，如果读ID立刻从正确的0xEF4018变成0xFFFFFF，说明你的SPI外设和W25Q128的通信链路是通的，只是模式不匹配。如果改成High后读出来的ID还是0xEF4018，那就有意思了——说明你的W25Q128可能工作在Dual或者Quad模式，或者硬件上CS的控制有问题，跟时钟极性没关系。
这种调试思路比盲猜有效得多，能帮助你快速缩小问题范围，不用一上来就把所有参数全改一遍。
4.4 布线注意事项和极端情况
最后说说布线。很多开发板和传感器模块是用杜邦线连接的，SPI时钟频率一高，杜邦线就变成天线了。实测中，用杜邦线连接时，36MHz时钟下波形已经有明显过冲和振铃，边缘变得很差。如果你只是验证功能，18MHz分频（Prescaler=4）会更稳妥；如果你要做产品或者需要高速率，PCB上SPI走线尽量短，且线和线之间拉开距离，信号线不交叉。
还有一点要特别注意：当W25Q128处于写状态并且正在页编程或者扇区擦除时，不要突然断电。如果断电发生在擦除过程中，Flash内部的数据可能损坏，严重时可能导致整个扇区无法继续擦写。工业产品里一般会在电源上加掉电检测和延时断电电路，起码保证掉电前能有机会完成擦除操作或者保存关键数据。
另外，W25Q128虽然支持每个扇区10万次擦写寿命，但频繁擦写同一个扇区，寿命很快会耗尽。我设计数据存储方案时，通常是安排多个扇区轮换写入，每个扇区写满后再切换下一个，应用程序记录当前写入的扇区号，这样能大大延长Flash的实际使用寿命。
5. 写在最后的个人经验
做嵌入式开发这些年，W25Q128这颗芯片真的陪我走过不少项目。从最早用模拟SPI慢慢读，到后来换硬件SPI，再到把DMA加进去，整个性能提升的过程非常直观。性能提升是一方面，更重要的是DMA让系统架构变得更合理——主控不用一直傻等Flash传输完成，可以把时间花在更重要的逻辑上。
有一个小细节我一直想强调：CubeMX只是生成初始代码的起点，不代表它生成的代码就是最优的。比如DMA的中断回调函数，CubeMX默认生成的HAL_SPI_TxRxCpltCallback()是__weak修饰的，真正的处理逻辑需要你自己在用户文件里重写。很多人漏了这一步，导致DMA传输完了，程序却不知道传输已经结束，白白浪费了DMA的优势。
如果你照着这篇文章动手做一遍，我建议你在自己的板子上先跑一个最简单的测试：读ID，擦除一个扇区，写入256字节，再读回来校验。这个过程跑通了，剩下的无非就是在这个基础上加功能。踩过坑、调过波形之后，你才算真正掌握了SPI和W25Q128这套组合，以后再遇到别的SPI设备（比如LCD屏、SD卡、传感器），底层逻辑都是相通的。
最后再分享一个小技巧：调试W25Q128的时候，多利用Flash的“读状态寄存器”指令。只要这条命令能返回正确状态，基本可以判断SPI通信是通的；如果连状态寄存器都读不到数据，问题大概率在硬件连接或者CubeMX的基础配置上，不用纠结是不是DMA配置错了。
