解决Java文件复制时InvalidPathException：非法字符问题

花韻仙語

发布时间：2025-09-26 16:46:01

703人浏览过

来源于php中文网

原创

解决java文件复制时invalidpathexception：非法字符问题

在Java程序中复制文件时，可能会遇到java.nio.file.InvalidPathException，提示“Illegal char”错误。这通常是由于目标文件路径包含了在文件系统中不允许使用的字符导致的。本文将详细介绍如何避免此类错误，并提供清晰的代码示例和注意事项，帮助开发者安全有效地复制文件。

问题分析

java.nio.file.InvalidPathException 异常表明你尝试创建的文件路径包含非法字符。在Windows系统中，常见非法字符包括、:、"、/、\、|、?、* 等。在提供的代码示例中，异常信息显示非法字符为 :，位于时间格式化后的字符串中。

Exception in thread "AWT-EventQueue-0" java.nio.file.InvalidPathException: Illegal char <:> at index 2: D:\\DOFN Materials\\App\\LMSystem\\Copy\\back14-11-2022 12:19:06\_LMSystem

这段错误信息表明，由于在文件名中直接使用了包含冒号的时间字符串（例如 "12:19:06"），导致创建文件路径失败。

解决方案

要解决此问题，需要确保生成的文件名不包含任何非法字符。以下是推荐的解决方案：

立即学习“Java免费学习笔记（深入）”；

DubbingX智声云配

多情绪免费克隆AI音频工具

下载

使用java.time API进行日期时间格式化：避免使用SimpleDateFormat，推荐使用java.time包下的类，例如LocalDateTime和DateTimeFormatter。
移除或替换非法字符：在将日期时间字符串添加到文件名之前，移除或替换所有非法字符。例如，可以将冒号替换为下划线或连字符。
使用Paths.get()创建Path对象：使用Paths.get()替代new File()来创建文件路径，这是新API推荐的做法。
检查路径中的空格：确保文件路径中没有多余的空格，因为空格也是路径问题的一个常见来源。

代码示例

以下是修改后的代码示例，展示了如何安全地复制文件并避免InvalidPathException：

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.util.logging.Level;
import java.util.logging.Logger;
import javax.swing.JOptionPane;

public class FileCopyExample {

    public void copyFile() {
        try {
            // 1. 使用 java.time API 获取当前时间并格式化
            LocalDateTime now = LocalDateTime.now();
            DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd-MM-yyyy_HH-mm-ss");
            String formattedDate = now.format(formatter);

            // 2. 定义源文件和目标文件路径
            Path sourceFile = Paths.get("D:\\DOFN Materials\\App\\LMSystem\\LMSystem.sqlite");
            //注意：这里使用Paths.get()替代new File()

            // 3. 构建目标文件路径，并使用格式化后的日期时间字符串
            Path destinationFile = Paths.get("D:\\DOFN Materials\\App\\LMSystem\\Copy\\back" + formattedDate + "_LMSystem");

            // 4. 复制文件
            Files.copy(sourceFile, destinationFile, StandardCopyOption.REPLACE_EXISTING);

            System.out.println("File copied successfully!");
            JOptionPane.showMessageDialog(null, formattedDate + " Copy Successfully !!");

        } catch (IOException ex) {
            Logger.getLogger(FileCopyExample.class.getName()).log(Level.SEVERE, null, ex);
            JOptionPane.showMessageDialog(null, "Error copying file: " + ex.getMessage(), "Error", JOptionPane.ERROR_MESSAGE);
        }
    }

    public static void main(String[] args) {
        FileCopyExample example = new FileCopyExample();
        example.copyFile();
    }
}

代码解释：