syncfailedexception 表示内核 sync() 调用失败，数据未能落盘，直指物理 i/o 栈断裂，常见于 nfs、usb 存储、ext4 挂载不当等场景，需按业务一致性要求分级处理。
SyncFailedException 不是普通 IO 错误，而是 Java 明确告诉你：系统已调用底层 sync() 指令，但内核返回失败（如 EIO、ENOTSUP 或超时无响应），数据**未能按预期落盘**。它直指物理 I/O 栈的断裂点，不是代码写错了，而是存储环境不满足强持久化承诺。
触发 SyncFailedException 的典型物理场景
该异常几乎只在你主动要求“数据必须上磁盘”时暴露，背后是硬件、驱动、文件系统、网络协议多层能力缺失：
- NFS/CIFS/Samba 共享目录 —— 大部分网络文件系统根本不实现真正的
fsync语义，Java 调用后内核直接返回ENOTSUP - USB 闪存盘、SD 卡、老旧移动硬盘 —— 固件常静默忽略
sync请求，或断电后无法保证缓存刷出 - Linux ext4 挂载参数不当 —— 如
barrier=0或data=writeback，且磁盘本身不支持 FLUSH 指令时，sync可能失败或降级 - Android/HarmonyOS 外置存储（尤其 FAT32）—— 内核对
sync()直接返回 -1，JVM 封装为SyncFailedException
为什么 flush() 正常，sync() 却失败？
flush() 和 sync() 作用层级完全不同：
-
OutputStream.flush()仅清空 Java 层缓冲区，把数据交给 OS 内核页缓存，不触达设备 -
FileDescriptor.sync()要求内核将对应文件描述符的所有脏页 + 元数据强制刷到**物理介质控制器**，全程依赖 I/O 栈每一环支持 - 常见误区：用
BufferedOutputStream写完没调flush()就直接sync()→ 数据还在 Java 缓冲区，sync()实际同步的是空内容
捕获后该怎么处理？不能吞，也不能硬抛
这个异常必须分类响应，关键看业务对数据一致性的容忍度：
- 非关键日志、临时缓存 —— 可降级为
force(false)（只刷页缓存，不保证落盘），并记录 WARN 日志 - 金融流水、WAL 日志、事务型落盘 —— 必须中断流程，触发告警、人工核查，绝不可跳过或自动重试
- JDK 9+ 需注意：
FileChannel.force(true)在某些文件系统上会静默转为false，建议提前用FileStore.supportsFileAttributeView(PosixFileAttributeView.class)辅助判断能力边界
sync() 成功 ≠ 数据绝对安全
即使 sync() 返回成功，也不代表断电后数据 100% 可恢复：
- SSD 内部写缓存未禁用（如未设
cache=none）仍可能丢失 - RAID 卡电池失效时，其 write-back 缓存失去保护
- ext4 的
journal=ordered模式下，sync 只保证元数据落盘，数据块可能还在缓存中 - sync 仅作用于当前打开的
FileDescriptor，对其他进程或路径的同名文件无效
