解决含特殊字符文件名引发的java.nio.file.InvalidPathException异常

核心原因 #

这个异常是因为Unix系统下，Java将路径字符串转换为系统路径时，无法将某些非ASCII字符（比如文件名里的É、ÃO）映射到当前环境的编码。虽然你设置了-Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8，但Docker容器的系统层面编码可能未同步为UTF-8，或者路径字符串本身存在编码不一致问题。

具体修复步骤 #

1. 同步Docker容器的系统区域编码为UTF-8 #

Java的sun.jnu.encoding参数依赖容器的系统区域设置，仅设置JVM参数不足以解决问题，需要在Dockerfile中添加系统编码配置：

# 安装并配置UTF-8区域（Debian/Ubuntu镜像为例）
RUN apt-get update && apt-get install -y --no-install-recommends locales && \
    locale-gen en_US.UTF-8 && \
    update-locale LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8

# 设置环境变量指定系统编码
ENV LANG=en_US.UTF-8
ENV LC_ALL=en_US.UTF-8

如果是Alpine镜像，改用以下命令：

RUN apk add --no-cache musl-locales musl-locales-lang
ENV LANG=en_US.UTF-8
ENV LC_ALL=en_US.UTF-8

2. 确保路径字符串的编码正确性 #

如果file变量来自外部输入（比如目录扫描、HTTP请求、数据库），需要确保获取字符串时使用UTF-8编码：

• 扫描目录时，Java在正确的系统编码下会自动获取正确的文件名，但如果之前有手动编码转换，要避免错误的转码操作。
• 若字符串来自外部接口，显式指定UTF-8解码：

  // 示例：从字节流中解码为UTF-8字符串
  String file = new String(inputBytes, StandardCharsets.UTF_8);
  

3. 显式指定编码构造路径 #

避免直接使用Paths.get(file)，改为显式基于UTF-8编码构造路径，确保字符串到系统路径的转换无编码偏差：

import java.nio.charset.StandardCharsets;
import java.nio.file.FileSystems;
import java.nio.file.Path;

// 显式用UTF-8解析路径字符串
Path path = FileSystems.getDefault().getPath(
    new String(file.getBytes(StandardCharsets.UTF_8), StandardCharsets.UTF_8)
);
// 再执行文件操作
String contentType = Files.probeContentType(path);

4. 验证JVM参数的启动位置 #

确保JVM参数添加在Java启动命令的正确位置，参数要放在-jar或主类名之前，否则会被当成程序参数而非JVM参数：

# 正确写法
java -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -jar your-application.jar

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