SD卡数据记录这种活儿看起来简单不就是开个文件、写数据、关文件嘛。但真正在野外跑起来十个项目里有八个会栽在同一个坑上设备刚上电时一切正常日志一条条往里写看着很顺利。可过了几分钟、几小时最多撑不过一天日志就悄悄停了。你翻SD卡前半段数据好好的后半段什么都没有连个报错残留都没有。要是重启一下设备它又能正常记录一段时间然后再次沉默。这种“只记录短时间”的问题我这些年修过不知道多少次从Arduino级别的小记录仪到工业级的采集盒子都遇到过。今天把排查思路和根因一次性讲透。先说个反直觉的结论大部分“记录中断”根本不是SD卡坏了也不是程序逻辑里写文件那行代码出了问题。真正的原因是系统某个环节被堵死、被饿死、或者被电压波动打了个措手不及。只是这些问题全都暴露在“SD卡写入”这一步上所以看起来像是卡的错。你要是不把思路从“写文件”上挪开光盯着SD卡换卡、换格式化工具问题永远复现、永远修不好。下面对标我实际踩过的场景按“现象 - 根因 - 验证 - 根治”的顺序拆开讲顺带附上可以直接抄作业的排查流程。1. 先还原现场短时记录背后的三类典型表象排查之前先搞清楚你到底面对的是哪种“停”。同样是记录中断表象不同指向的根因完全不同。我最怕收到的问题描述就是“它停了”没别的了。你一定要去把SD卡拿回来看文件系统实际长什么样这会直接砍掉一半的排查分支。1.1 表象A文件系统完好日志戛然而止最常见的一种。SD卡插到电脑上文件系统能正常识别目录结构也没坏就是最后一个文件写到某个时间点之后不再增长。文件大小停在几十KB、几MB打开看末尾是完整的半行数据没有乱码没有截断痕迹。这种表象往往指向逻辑层面的停止——程序还在跑或者已经死了但无论如何都没有再执行写入操作。常见原因包括缓冲区写满后主循环被阻塞系统进入死锁或看门狗复位。采样线程崩了或者FIFO队列满了之后写入线程被暂停又没有恢复机制。文件打开失败后错误处理分支里有个while(1)死循环代码就停在那了。判断方法很简单看最后一条数据的时间戳和程序预期行为是否对齐。如果最后一条数据正好卡在某个整点、某个采集周期边界大概率是软件逻辑问题而不是硬件问题。1.2 表象B文件损坏、目录乱码、卡上出现碎片文件SD卡拔下来插电脑系统提示需要格式化或者目录里出现一堆“.$$$”临时文件、文件名变成乱码、文件大小为0。这种属于写入过程中突然掉电或复位FAT表没来得及更新。注意一个容易被忽略的细节SD卡写入不是直接改扇区而是先写数据区再写FAT表。如果中途断电数据区可能已经写进去了但FAT表没更新表现出来就是文件大小不对、数据在但文件打不开、或者残留一堆临时文件。这种情况在电池供电的设备上尤其常见。电池电压随着放电逐渐下降当电压跌到SD卡或主控的最低工作电压附近时系统会处于一种“半死不活”的状态——主控还在运行SD卡却开始丢响应程序反复重试最终卡死或复位。复位瞬间如果正好在写FAT表文件系统就烂了。1.3 表象CSD卡“消失”必须重新插拔才能恢复这种最诡异程序还在跑指示灯还闪着但SD卡就是读不到、写不进。你通过串口打印调试信息会看到类似“card init failed”或者“write timeout”的错误。重启程序没用必须物理断电或者把卡拔出来重新插进去才能重新初始化。这种往往是SD卡进入了保护状态或者电气连接出现异常。常见原因SPI模式下SD卡被错误的电平信号干扰进入休眠或错误状态。电源纹波过大导致卡内部逻辑混乱但主控还能撑住。卡座接触不良振动环境下偶发性断路。更隐蔽的情况你的程序在检测到写错误后没有做重新初始化而是直接放弃之后所有写入尝试都走错误分支表现为“卡消失了”。这三种表象经常混合出现。比如先有电压波动导致写失败程序处理不当又引发逻辑死循环最后表现出来既是B又是A。所以拿到卡之后先做一件最基础的事把卡挂到电脑上用磁盘检查工具扫一遍然后直接看卡里日志文件的十六进制末尾记录它“死在哪个操作上”。2. 缓冲区与写入速度的失衡数据记录中断的第一大元凶2.1 缓冲区为什么会满采样率与写入速率的静态计算很多记录中断根源就是一句话采样速率 写入速率缓冲区被填满没有退路。在MCU环境下SD卡的写入速度远低于你想象的数字。以常见的SPI模式SD卡为例实测连续写入速度不计文件系统和磨损均衡大致在SPI时钟20MHz单块写入大约500~700 KB/sSPI时钟10MHz单块写入大约250~350 KB/s如果用的是FatFs 写小文件 每写一次就flush一次速度可能掉到几十KB/s甚至更低。而你如果以较高的采样率在采集数据比如每通道1kHz、双通道、每个样本2字节那一秒就是4KB看起来不多但如果你的采集任务里还有波形计算、浮点运算、显示刷新、无线发送主控能留给SD卡的时间远没有你以为的那么多。我遇到过最典型的案例一个设备采集加速度计数据采样率2kHz每个样本6字节理论上每秒12KBSD卡完全扛得住。但程序用的是单缓冲主循环里先采集一批数据然后调用f_write写入。f_write内部要先查FatFs的状态、移动文件指针、搬数据到内部扇区缓冲实际耗时可能高达几十毫秒。在写入期间中断照常触发采集数据往哪放只能放同一个缓冲区。缓冲区被覆盖数据丢了程序却完全不知道。然后系统继续运行表现就是日志文件有数据但数据中间缺了一大段看着像“记录了一段时间就停了”。如果你用的缓冲区是固定数组没有做“满了就丢弃”或“满了就覆盖”的策略那缓冲区写满后唯一的下场就是写指针覆盖读指针或者主循环阻塞等待缓冲区空出来——而缓冲区永远不会空因为写入线程也被卡住了。2.2 致命习惯只在缓冲区满时才一次性写入新手最常犯的错误是采集数据放到缓冲区等缓冲区满了才一次性写SD卡。这个设计貌似合理缓冲区大小设成512的整数倍一次写入正好一个扇区效率最高。但问题在于缓冲区满之前的那段时间如果采集线程一直在填写入线程没有机会介入。具体来说假设缓冲区是4KB采集速率是2KB/s那么2秒后缓冲区满了。这时候触发f_write写入4KB数据。在写入期间采集线程继续运行又产生了新数据。新数据往哪放缓冲区还是那4KB已经被写入线程锁住或者正在被读取。要么丢数据要么阻塞采集线程要么双线程共享缓冲区互相踩踏。解决思路只有两个方向双缓冲交替写入采集线程写Buffer A满了之后切换Buffer B同时把Buffer A交给SD卡写入。写入期间采集线程继续用Buffer B互不干扰。环形缓冲 丢旧保新或丢新保旧写入线程持续工作缓冲区始终留有余量满了就覆盖最旧的数据。这两个方案不只是实现差异背后的可靠性模型完全不同。双缓冲在数据完整性上更好但对时序要求高你必须在缓冲区切换间隙完成所有写入环形缓冲在实现上更简单但必须有明确的数据丢失策略并且要在日志里标记丢了多少数据否则后续分析数据时会被误导。2.3 写入完成时间是个系统性杀手很多人只算平均写入速度忘了算最坏写入时间。SD卡的写入速度不是恒定的实际测试中blocking write单次512字节的耗时可能从几毫秒到几百毫秒不等。特别是在跨FAT簇边界时需要额外读改写FAT表文件系统碎片化之后写入前需要查找空闲簇劣质卡或老卡的擦除操作特别慢卡接近满时闪存内部GC垃圾回收占用大量时间。如果你在主循环里同步调用f_write那f_write最坏耗时几百毫秒意味着你的系统每写一笔数据就“卡顿”几百毫秒。采样线程如果在这段时间里被阻塞就会丢数据如果采样靠中断中断服务程序里塞了采集逻辑那直接就是中断丢失数据采不全。所以凡是采样率超过1kHz、单次写入数据量超过512字节的场景我强烈建议用RTOS 任务间队列或者状态机 环形缓冲来解耦采集和写入。采集任务只负责往队列里丢数据写入任务在空闲时批量取数据、批量写SD卡。这样SD卡写入再怎么慢都不影响采集时序。从实操上看我常用的一个判断公式是缓冲区大小字节 / 采样速率字节每秒 最长可容忍写入阻塞时间秒只要这个值小于SD卡最坏写入耗时一定会出问题。你把这个值算出来很多“只记录几分钟”的谜团当场就解开了。3. 电源与电气问题SD卡在关键时刻“掉线”的真实原因3.1 电流尖峰与电压跌落数据量越大越明显SD卡写入时电流不是恒定的峰值电流出现在擦除和编程阶段特别是在写满一个块、需要搬移数据的时候。瞬时电流可以达到100mA甚至更高如果供电链路阻抗大电压会被瞬间拉低。MCU数据记录设备大多是3.3V供电很多直接用AMS1117之类的LDO从5V或锂电池降压。LDO的响应速度有限如果输入电压本身有波动或者输出端没有足够的钽电容/陶瓷电容做去耦SD卡写入瞬间的电压跌落很容易超过100mV。什么概念SD卡规范要求供电电压范围2.7V~3.6V。如果你的LDO输出标称3.3V纹波50mVSD卡写入时再跌200mV就到了3.05V。看起来还在范围内但加上电源轨上的高频噪声就可能跌破2.7V的瞬间阈值卡就复位了。最要命的是这种复位不一定整个系统都复位。MCU可能在2.7V以上仍然正常工作但SD卡已经悄悄重启了。SD卡重启后需要重新走一遍初始化流程而你的程序并不知道这件事继续按原样发写命令SD卡不响应程序超时、报错、退出。退出后如果没做好重试逻辑记录就停了。外部表现就是日志写了半小时然后没了但LED还在闪MCU也没死。3.2 线缆与卡座隐藏的串联电阻我在实测试验中发现很多“只在短时间记录”的问题根源在卡座接触电阻上。SD卡座的弹簧触片用久了会氧化接触电阻从几十毫欧涨到几百毫欧甚至1欧姆。如果设备还有振动接触电阻还会间歇性跳变。当写入电流达到100mA时1欧姆的接触电阻会产生100mV压降。再加上线缆、PCB走线的阻抗SD卡实际拿到的电压比主控低得多。很多人习惯把SD卡电源直接接到主控3.3V网络的末端中间经过一段细长走线SD卡写入时电压被拉到阈值以下卡复位记录中断。用示波器一测写得正欢的时候电源波形上有一个明显的下陷问题当场现行。如果你的设备在野外跑还要考虑温度。氧化层在低温下阻抗更高冬天更容易出问题。所以我后来做记录仪设计SD卡电源都会单独走线并且在卡座旁边加一个100uF的钽电容 0.1uF陶瓷电容做局部去耦减小电源跌落幅度。3.3 SPI模式下的信号完整性与上拉电阻用SPI模式驱动SD卡信号完整性要求其实不低。SD卡SPI模式有四个信号SCK、MOSI、MISO、CS。每条线都需要上拉电阻通常10kΩ到100kΩ。但如果上拉电阻缺失或者走线太长信号上升沿变缓高速SPI下就会出现间歇性通信错误。特别典型的坑是CS信号没拉好。如果CS悬空或上拉太弱SD卡可能进入未选中状态然后所有写命令都得不到响应。有的程序在写失败后重试几次然后又失败最后直接关闭文件退出。这样的问题在办公室调试时可能一天都不出现到了现场因为线缆更长、环境电磁干扰更强就开始“记录一段时间就断”。我建议SPI时钟先降到2MHz以下做稳定性测试。如果在4MHz下不稳定、2MHz下稳定那基本就是信号完整性问题而不是SD卡本身的问题。通过降速来确定是不是电气层面的问题非常直接有效。3.4 实测验证方法示波器是唯一靠谱的裁判排查电源问题时不用跟我争论理论直接测用示波器同时看SD卡VCC和GND用电流探头或串联采样电阻看写入电流让设备按最高速率写入数据持续跑几分钟到几十分钟观察每次写入时VCC的下陷幅度和恢复时间把数字万用表设置成最小/最大记录模式挂在VCC上跑一个完整的写入循环。如果VCC下陷超过100mV或者观测到低于2.7V的瞬态恭喜你找到根因了。如果波形很干净电压纹波小于30mV那再往逻辑层面查。有一类特殊情况SD卡和无线模块共用电源。蓝牙/WiFi/4G模块发射瞬间电流可以达到几百毫安甚至安培级直接把电压拉下去。这种“记录断”往往和无线发送的时间点高度相关。你在日志里比对一下时间戳如果中断时刻恰好和无线发送时间吻合那就不要怀疑SD卡了先给无线模块单独供电或者加电源时序控制。4. FAT文件系统边界4GB/2GB的硬限制与簇表异常4.1 FAT16和FAT32的单文件大小上限很多人不知道SD卡日志记录还有一个非常隐蔽的“定时炸弹”——FAT文件系统的单文件大小限制。FAT16格式的卷单文件最大2GBFAT32格式的卷单文件最大4GB超过之后f_write会返回错误大多数代码库不会正确处理这个错误程序就停了或者文件指针回绕覆盖已有数据。如果设备采样率不高2GB可能够跑很久。但如果你做的是高采样率记录仪比如一个16位、4通道、10kHz的采集系统每秒就是80KB一小时约288MB。FAT32的4GB上限大约只能撑14个小时。FAT16的2GB上限更是撑不到7个小时。更麻烦的是很多SD卡出厂时格式化成FAT32但簇大小是64KB这种格式能支持大文件但小文件写入性能极差跨簇边界时频繁更新FAT表写入速度可能掉到几KB/s。在长时间记录场景下我的做法是不用单文件无限增长而是设计轮转日志——数据写到一定大小比如512MB就关闭文件新建一个带序号的新文件在文件名里编码时间戳比如LOG_20250101_120000.bin程序启动时扫描已存在的日志文件按时间戳顺序写避免覆盖旧数据。这样既绕开了单文件大小限制又方便事后按时间段快速定位数据。如果你非要单文件连续写至少要先算清预计最大记录时长并确保目标文件系统格式支持。4.2 簇表异常与断电写入FAT文件系统是日志型文件系统的反面教材它在写数据时并不保证一致性。断电时具体会发生什么程序请求写4KB数据FatFs先更新FAT表标记数据要占用的簇。然后写数据到簇对应的扇区。最后更新目录项更新文件大小。如果第2步写完第3步没执行文件大小就没更新数据虽然写在卡里但文件系统不认。如果第2步刚写完FAT表还没来得及更新数据就是彻底的孤儿扇区目录项还在旧状态过一段时间会被新的写入覆盖掉。在电池供电的SD卡记录设备里这是一个非常常见的“记录了一段时间后文件损坏”的原因。解决办法不是靠软件能做到的只能从设计上减少暴露窗口增加一个掉电检测电路比如比较器检测电源电压低于阈值时触发MCU的紧急中断把正在缓冲的数据和FAT表状态刷到卡里然后安全关闭所有文件。如果没有掉电检测那就老老实实做轮转文件并且控制每次写入的数据量让FAT表更新的频率降低。注意不要频繁调用f_sync或者f_flush。每写一个扇区就flush一次虽然安全性提高但写入速度和闪存寿命都会显著下降。我一般设置一个合理的同步间隔比如每写256KB同步一次或者每5秒同步一次根据数据的重要程度和系统掉电频率来权衡。4.3 格式化工具与SD卡初始化细节标题下面带了几个热搜词“sd card formatter”“sd memory card formatter”。说明很多人在卡出问题后第一反应是重新格式化。这方向没错但要注意格式化的参数。SD卡官方推荐的格式化工具会按照SD卡的实际能力设置默认格式和扇区大小比操作系统自带的格式化更可靠。但有一点很重要不要在卡上建立多个分区SD卡日志记录场景只用一个分区就够了。多个分区在MCU环境下处理容易出问题部分FatFs移植代码不支持多分区或者会默认访问错误的分区号。另外有一个细节容易忽略SD卡可能存在“逻辑保护”卡上的拨杆Lock开关如果拨到锁定位置写入时卡会返回错误。这个开关是一个机械触点在振动环境下可能松动导致写一半突然变只读。这种问题非常无厘头但确实发生过。调试的时候先检查这个开关别一上来就去改代码。还有如果你用的是工业级或者三防SD卡它们有的支持“写保护”命令即使没有机械开关也可能拒绝写入。这种卡拿回来先读一下CSD寄存器的写保护位省得后面排查半天。5. 完整排查链路从串口日志到波形测量的定位方法论很多朋友反映这些问题太难定位。其实不难按顺序执行下面这套排查链路大概率能在半天内锁定根因而不需要靠猜。5.1 第一步在日志里标记“最后存活时刻”先别急着改硬件先把你手头的设备接上串口调试线打开所有调试输出。在程序的关键节点加上日志输出每次成功打开文件的时间每次f_write返回的字节数和耗时每次f_sync调用的返回码初始化失败、写失败、重试的次数。然后反复运行设备直到问题复现。注意看串口输出的最后一条日志是什么。这一条日志会直接告诉你问题发生的上下文如果最后一条是“write timeout”说明卡没响应要查电源和信号如果最后一条是“file open failed”说明文件系统已经挂了如果最后一条什么都不是串口也没输出那大概率是MCU死了或者进入异常状态。这一步不需要任何额外工具但能砍掉一半的排查路径。90%的人跳过了这一步直接去换卡纯属浪费生命。5.2 第二步跑一个写入压力测试隔离硬件问题如果串口日志看不出明确结论就做一次纯粹的SD卡压测。写一段小程序不要采集任何传感器数据直接全速往SD卡写入固定大小的块持续跑1小时同时用示波器监视SD卡VCC和SCK线上的信号。如果压测期间出问题说明问题在硬件链路或SD卡本身和你的业务逻辑无关。如果压测稳定说明问题出在数据采集/缓冲/任务调度层业务逻辑中的某个环节导致SD卡写入被饿死或者被阻塞。注意压测时写入模式要对齐实际场景不要只测顺序大块写。要复现你实际代码里的写入模式包括块大小、写入频率、文件打开关闭频率。不然压测结果对定位没有参考价值。5.3 第三步换卡交叉测试 格式化工具重建如果压测期间出问题做交叉测试同一张卡换到另一台设备上跑压测另一张卡换到这台设备上跑压测新卡先跑官方SD卡格式化工具再跑压测。注意SD卡速度和可靠性是两个维度。当前市面上很多所谓“高速卡”在连续写入中的表现反而不如一些老旧的工业卡。有些卡对SPI模式支持不好或者不支持部分CMD命令。买卡的时候别只盯着速度等级优先选标注了“工业级”“宽温”或者明确支持SPI模式的卡。如果你排查到这一步还没结论可以从这几个方向继续检查CSD寄存器确认SD卡容量和块大小用逻辑分析仪抓SPI通信看命令响应是否正常检查文件系统格式化参数是否和代码假设一致。5.4 第四步用示波器抓SD卡的“死亡瞬间”这是最后一步也是最硬核的一步。在问题复现时刻用示波器同时抓SD卡VCC对GND的波形SD卡MISO线上的波形主控IO口上一个标记信号比如写失败中断时拉高。如果问题复现时VCC出现了明显的跌落那电源问题实锤。如果VCC没问题MISO线上出现异常电平或者长时间无响应那就是SD卡状态机跑飞了。如果一切波形都正常但写程序就是失败那就要检查代码中是不是有什么逻辑bug比如中断优先级搞乱了、看门狗误触发、缓冲区指针越界等。我个人的经验是80%的“只记录短时间”问题能在第二步和第三步被锁定。真正需要示波器出场的主要是电源纹波和信号完整性这两类隐蔽问题。6. 架构层面的根治方案让记录器稳定运行数周的设计经验排查和修复不是终点。如果项目要长时间稳定运行还是得在架构上做减法。下面是我现在做SD卡记录仪默认采用的方案按“抗故障优先级”排列。6.1 双缓冲 任务解耦让采集和写入彻底隔离无论你用不用RTOS都建议把采集和写入拆成两条执行路径。采集路径只负责把数据丢进队列写入路径只负责从队列取数据、批量写SD卡。两条路径之间用环形缓冲或消息队列连接缓冲区大小按最坏情况计算。具体参数建议环形缓冲区大小至少是最大写块大小的4倍以上推荐8KB或更大写入任务优先级低于采集任务但高于普通计算任务队列满时策略是丢弃最旧的数据并在日志头部做个标记比如丢了多少字节。这样即使SD卡写入卡顿几百毫秒采集任务也不丢一点数据只是环形缓冲暂时积压等写入恢复后再慢慢消化。6.2 健康监控与自动恢复不让程序“死等”SD卡写入失败时代码绝对不能死等重试。推荐实现一个“SD卡健康监控”模块检测到连续N次写入失败比如10次就切换到“故障模式”在故障模式下停止写入保留数据到RAM缓冲区或铁电存储器定期尝试重新初始化SD卡发送CMD0、CMD1、CMD8、ACMD41等初始化命令成功后再恢复写入如果重试超过阈值记录错误状态通过其他通道如无线上报故障。看门狗要独立出来喂狗操作放在主循环里不要在SD卡写入中断里喂狗否则SD卡卡死时看门狗被错误喂掉系统永远无法复位。6.3 轮转日志 掉电检测从根上绕开FAT表异常前面提过轮转日志。这个设计不只是绕开单文件大小限制更大的价值在于故障隔离。一个文件坏了不影响其他文件。程序启动时对所有文件做完整性检查损坏的文件自动隔离新数据继续写入新文件。掉电检测电路也很关键。简单方案RESET引脚或ADC引脚接一个分压电阻检测主电源电压。当电压低于阈值时触发中断中断里做两件事关闭当前文件f_close会更新FAT表和目录项把缓冲区里剩余的数据尽量写出去如果时间允许。如果电压跌得太快连写操作都来不及完成那就只能靠轮转日志兜底至少旧的日志不会受到太大破坏。6.4 选卡、格式化与使用习惯的终极大考最后给几张卡的选择和基本使用习惯做个建议项目建议理由卡的类型工业级、宽温、MLC以上比消费级卡稳定不容易在高温/振动下掉速容量大小32GB以下大容量卡在FAT32格式化时簇大小文件写入慢32GB以下兼容性最好文件系统FAT32簇大小16KB或32KB平衡写入速度和空间浪费格式化工具官方SD Card Formatter能正确设置扇区和文件系统参数写入模式批量顺序写避免频繁随机小写减少GC频率降低写入耗时的抖动数据备份定期导出日志格式化后重用卡长时间使用后GC碎片化速度会明显下降个人实际测试中最稳定的组合是32GB工业级microSD卡FAT32格式簇大小32KBSPI时钟10MHz每次写入2048字节或4096字节每写入256KB做一次同步。这种配置下连续写入速度大约300KB/s稳定跑一个月没出过问题。最后提醒一个常见误区SD卡不是硬盘别拿它当随机读写的存储介质用。它的强项是顺序大块写。任何频繁打开关闭文件、频繁写小数据量的设计都是在跟闪存管理逻辑对着干最终都会以“记录中断”或者“文件损坏”收场。