Dynamic Web Project中Servlet调用mkdir()创建目录失败

核心问题排查点 #

• 路径拼接错误：getServletContext().getRealPath("")返回的Web应用根路径末尾不保证携带文件分隔符，直接拼接自定义路径会生成错误的串连路径，例如返回根路径为/opt/tomcat/webapps/demo时，直接拼接后会得到/opt/tomcat/webapps/demoimageProdotto/test这类无效路径。
• 方法使用错误：mkdir()仅支持创建单级目录，如果你要创建的test目录的上级目录imageProdotto不存在，调用该方法必然返回false。
• 文件系统权限不足：运行Web容器的系统用户（如tomcat、www-data）对目标路径所在的磁盘目录没有写入权限，无法创建新目录。
• 目标目录已存在：mkdir()在目标目录已经存在的情况下会直接返回false，属于方法本身的正常逻辑，不是执行异常。
• 部署模式限制：如果应用以未解压的WAR包形式运行，getRealPath("")会返回null或者虚拟映射路径，无法对应真实磁盘位置，自然无法创建目录。

可直接落地的修复方案 #

• 避免手动拼接路径分隔符，使用File类自带的父子路径构造方法自动适配不同操作系统的分隔符规则。
• 替换mkdir()为mkdirs()，该方法支持递归创建路径中所有不存在的父级目录。
• 创建目录前先做存在性校验，创建失败时打印目标绝对路径、父目录写入权限等信息方便定位问题。
• 生产环境不建议将上传文件存储在Web应用部署目录下，避免应用重新部署、WAR包重新解压时上传文件被清空，建议配置Web容器外的独立磁盘路径作为上传存储根目录。

修复后参考代码 #

// 生产环境建议替换为配置文件读取的独立存储路径，例：String basePath = "/data/web/upload";
String appRealPath = getServletContext().getRealPath("");
String relativeDir = "imageProdotto" + File.separator + "test";
// 自动处理路径分隔符拼接，避免手动拼接出现的路径格式错误
File uploadDir = new File(appRealPath, relativeDir);

if (!uploadDir.exists()) {
    // 递归创建多级目录，不要使用仅支持单级创建的mkdir()
    boolean createSuccess = uploadDir.mkdirs();
    if (createSuccess) {
        System.out.println("目录创建成功，路径：" + uploadDir.getAbsolutePath());
    } else {
        System.out.println("目录创建失败，目标路径：" + uploadDir.getAbsolutePath());
        System.out.println("父目录是否存在：" + uploadDir.getParentFile().exists());
        System.out.println("父目录是否有写入权限：" + uploadDir.getParentFile().canWrite());
    }
} else {
    System.out.println("目标目录已存在，无需重复创建");
}

注意：如果执行时发现getRealPath()返回null，说明当前容器以不解压WAR包的模式运行，基于Web应用根路径创建目录的方案完全不可用，必须切换到外部独立磁盘路径存储文件，同时提前给Web容器的运行用户分配对应路径的读写权限。

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