Linux文件系统中Files.createDirectories创建大量目录失败求助

核心原因排查 #

报错No space left on device并非一定是磁盘空间耗尽，结合你有1亿个目录的场景，优先排查以下Linux特有的问题：

• inode耗尽：Linux中每个文件/目录都需要占用一个inode，当文件系统的inode总数被用完时，即便磁盘还有剩余空间，也无法创建新的目录/文件。1亿个目录会消耗大量inode，这是最可能的原因。
• 磁盘空间真的不足：生产环境磁盘可能已被占满，但结合目录规模，inode问题优先级更高。
• Docker挂载限制：如果/home/tempAttachment是挂载到容器内的目录，需确认宿主机对应路径的文件系统inode配额，或容器是否配置了存储资源限制。

验证步骤 #

1. 检查inode使用情况：在生产环境执行命令：

   df -i /home/tempAttachment
   

   查看输出中的IUsed（已用inode数）和ITotal（总inode数），若IUsed接近ITotal，即可确认是inode耗尽。
2. 检查磁盘空间：执行命令确认磁盘剩余空间：

   df -h /home/tempAttachment
   

3. 检查Docker挂载配置：查看容器挂载命令，确认宿主机对应挂载路径的文件系统状态，同时检查容器是否有--storage-opt等存储限制参数。

代码优化建议 #

你的代码虽然加了synchronized，但存在冗余判断，且多实例部署时synchronized无法跨JVM生效，可简化为：

public static File getFile(String filePath) throws IOException {
    Path parentPath = Paths.get(filePath).getParent();
    if (parentPath != null) {
        // createDirectories会自动处理目录已存在的情况，无需提前判断
        Files.createDirectories(parentPath);
    }
    return new File(filePath);
}

注：若为多实例部署，需配合分布式锁避免目录创建的竞态，但这不是当前报错的直接原因。

本地复现失败的原因 #

本地无法复现，通常是以下因素导致：

• 本地文件系统inode总数远大于生产环境：比如ext4默认inode占比约1%，100G磁盘仅能提供几百万inode，而你生产环境可能磁盘容量有限，1亿个目录早已耗尽inode。
• 本地未创建足够数量的目录，或使用了无inode概念的文件系统（如Windows NTFS）。

解决措施 #

1. 清理冗余目录：若旧目录无需保留，批量删除（操作前务必备份重要数据）：

   find /home/tempAttachment -type d -delete
   

2. 调整文件系统inode配额：若需保留大量目录，可重新格式化文件系统时指定更高的inode密度，例如ext4文件系统：

   # 备份数据后执行，每个inode占用1024字节，可大幅提升inode总数
   mkfs.ext4 -i 1024 /dev/sdX
   

3. 优化目录结构：避免单层级存储1亿个目录，改为多级哈希拆分结构（例如取目录名前2位作为一级目录，接下来2位作为二级目录），既减少单目录条目数，也能延缓inode耗尽。
4. Docker配置调整：确保容器挂载的宿主机路径所在文件系统有足够inode，或改用支持动态inode的文件系统（如XFS）。

内容的提问来源于stack exchange，提问作者chiku