STM32 FatFS连续写入SD卡数据丢失？3个常见坑点与实战修复方案

STM32 FatFS连续写入SD卡数据丢失3个常见坑点与实战修复方案最近在调试STM32的SD卡数据记录功能时遇到了一个让人头疼的问题使用FatFS库连续写入数据时SD卡中的文件要么是空的要么全是乱码。经过一番折腾终于找到了问题的根源。如果你也遇到了类似的情况这篇文章或许能帮你少走弯路。1. 参数设置错误FA_CREATE_ALWAYS的陷阱刚开始使用FatFS时我习惯性地在f_open()函数中使用了FA_CREATE_ALWAYS参数结果每次写入都会覆盖之前的数据。这个参数会强制创建一个新文件即使同名文件已经存在。对于需要连续写入数据的场景这显然是个大坑。正确的做法是// 错误示例 - 会覆盖已有文件 f_open(file, data.txt, FA_CREATE_ALWAYS | FA_WRITE); // 正确示例 - 打开现有文件准备写入 f_open(file, data.txt, FA_WRITE);关键点对比参数行为适用场景FA_CREATE_ALWAYS总是创建新文件单次写入FA_WRITE打开现有文件连续写入FA_OPEN_EXISTING仅打开已有文件读取或追加提示首次打开文件时可以组合使用FA_OPEN_EXISTING和FA_WRITE确保不会意外创建新文件。2. 文件同步问题为什么数据会丢失在调试过程中我发现即使正确写入了数据断电后文件内容还是会丢失。这是因为FatFS采用了缓存机制数据不会立即写入物理存储。这就好比在电脑上编辑文档后没有按CtrlS保存。解决方法有两种使用f_sync()强制同步缓存使用f_close()关闭文件会自动调用f_sync()推荐的工作流程// 打开文件 f_open(file, data.txt, FA_WRITE); // 写入数据 f_printf(file, %s\r\n, sensor_data); // 立即同步到SD卡 f_sync(file); // 或者直接关闭文件 f_close(file);3. 指针偏移问题为什么只有最后一行数据最让人困惑的情况是明明调用了多次写入函数但文件里只有最后一次写入的数据。这通常是因为文件指针没有正确移动导致每次都在同一个位置写入。解决方法很简单在每次写入前将指针移动到文件末尾// 将指针移动到文件末尾 f_lseek(file, f_size(file)); // 然后写入新数据 f_write(file, new_data, strlen(new_data), bytes_written);完整连续写入示例// 初始化阶段 f_open(file, log.txt, FA_WRITE | FA_OPEN_APPEND); while(1) { // 获取传感器数据 get_sensor_data(buffer); // 写入数据 f_printf(file, %s\r\n, buffer); // 定期同步 if(count % 10 0) { f_sync(file); } // 适当延时 HAL_Delay(1000); } // 最终关闭 f_close(file);4. 高级技巧与性能优化对于需要高频写入的场景频繁打开/关闭文件或调用f_sync()会影响性能。这里分享几个优化建议批量写入收集一定量数据后一次性写入减少IO操作次数定时同步每N次写入执行一次f_sync()平衡数据安全性和性能错误处理检查每个函数调用的返回值确保操作成功错误处理示例FRESULT res; res f_open(file, data.txt, FA_WRITE); if(res ! FR_OK) { // 处理错误 error_handler(res); } res f_lseek(file, f_size(file)); if(res ! FR_OK) { // 处理错误 error_handler(res); }在实际项目中我还发现SD卡的质量和格式化方式也会影响稳定性。建议使用官方工具格式化SD卡为FAT32格式分配单元大小设为32KB或64KB以获得最佳性能。