0

0

Java中的InvalidPathException解析_不同操作系统下非法字符路径校验

P粉602998670

P粉602998670

发布时间:2026-03-08 10:30:12

|

551人浏览过

|

来源于php中文网

原创

windows下invalidpathexception常因路径含非法字符(如:、|、?、*)或保留名(如aux)触发,paths.get()会主动校验而new file().topath()不校验,跨平台需统一用paths.get()并清洗不可见字符。

java中的invalidpathexception解析_不同操作系统下非法字符路径校验

Windows下InvalidPathException常因:、<code>>触发

Java 7+ 的 Paths.get()FileSystems.getDefault().getPath() 在 Windows 上会主动校验路径非法字符,比如 :(除盘符外)、、<code>>|?*。这不是 JVM 层面的宽松处理,而是底层调用 Win32 API GetFullPathNameW 前做的预检。

常见错误现象:InvalidPathException: Illegal char <:> at index 5: C:/tmp/file:name.txt</:> —— 注意这里不是文件不存在,而是构造 Path 对象时就失败。

  • 别在文件名里用冒号,哪怕你只是想拼个日志名 "log-2024-06-12:14-30.txt",得换成 "log-2024-06-12_14-30.txt"
  • \? 前缀路径(Windows 扩展路径)不会被 Paths.get() 接受,它只认标准格式;要用就得走 new File("...").toPath() 绕过校验(但后续操作仍可能失败)
  • 注意 System.getProperty("file.separator") 返回 ,但字符串字面量里写 "C: mp est.txt" 会因转义崩掉,必须用 "C:\tmp\test.txt""C:/tmp/test.txt"

Linux/macOS 不校验非法字符,但InvalidPathException仍可能抛出

Unix 系统的 Paths.get() 默认不检查字符合法性,/tmp/file:name.txt 能成功构造 Path。但一旦调用 path.toFile().exists()Files.exists(path),底层 stat() 系统调用返回 ENOENT 或 EINVAL,某些 JDK 版本(如 OpenJDK 17+)会在封装异常时重抛为 InvalidPathException,提示 Malformed input or input contains unmappable characters

AI封面生成器
AI封面生成器

专业的AI封面生成工具,支持小红书、公众号、小说、红包、视频封面等多种类型,一键生成高质量封面图片。

下载
  • 根本原因往往是路径含不可见控制字符(如 u0000u0001)或 UTF-8 编码损坏,而非 : 这类符号
  • path.toString().codePoints().forEach(cp -> System.out.printf("%04x ", cp)) 查看每个码点,重点排查 0000fffd(替换符)
  • 从外部读取路径(如 HTTP 请求参数、数据库字段)时,务必做 String.strip() + String.replaceAll("[\x00-\x08\x0b\x0c\x0e-\x1f]", "") 清洗

Paths.get()new File().toPath() 行为差异

这是最容易踩坑的地方:前者严格校验,后者几乎不校验(仅检查 null),导致同一段路径字符串,在一个地方能过、另一个地方崩。

立即学习Java免费学习笔记(深入)”;

  • Paths.get("C:/tmp/aux.txt") → 直接抛 InvalidPathExceptionAUX 是 Windows 保留设备名)
  • new File("C:/tmp/aux.txt").toPath() → 成功返回 Path,但 Files.createFile(path) 会失败,报错 AccessDeniedException
  • 跨平台代码里,别混用两种构造方式;统一用 Paths.get() 更安全,它提前暴露问题
  • 如果必须兼容脏数据,先用 File.pathSeparator 拆分再逐段 Paths.get() 校验,比全量放行更可控

自定义路径校验工具类要避开 JDK 的隐式编码转换

有人写工具方法判断路径是否合法,用 Paths.get(path).toFile().getCanonicalPath() 捕获异常。这在中文路径下容易误判:JDK 内部会把 String 按系统默认编码转 byte[],再交由 OS 解析。若终端编码是 GBK,而 Java 启动参数没设 -Dfile.encoding=UTF-8"测试.txt" 可能变成乱码字节,触发 InvalidPathException

  • 校验逻辑里别调用任何涉及文件系统的 API(toFile()toUri()toRealPath()
  • 纯字符层校验只需三步:检查空值、检查首尾空格、检查操作系统保留名(CONPRNAUXNULCOM[1-9]LPT[1-9])和非法字符集
  • Windows 下保留名匹配需忽略大小写且不带扩展名,"con.txt""CON" 都非法,但 "console.txt" 合法
事情说清了就结束。最麻烦的从来不是字符列表,而是那些藏在 HTTP header、数据库 blob 字段、用户粘贴进来的不可见字符——它们不报错,直到某天在某个 JDK 版本、某台机器上突然炸开。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

970

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

253

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1049

2024.03.01

php中foreach用法
php中foreach用法

本专题整合了php中foreach用法的相关介绍,阅读专题下面的文章了解更多详细教程。

225

2025.12.04

printf用法大全
printf用法大全

php中文网为大家提供printf用法大全,以及其他printf函数的相关文章、相关下载资源以及各种相关课程,供大家免费下载体验。

76

2023.06.20

fprintf和printf的区别
fprintf和printf的区别

fprintf和printf的区别在于输出的目标不同,printf输出到标准输出流,而fprintf输出到指定的文件流。根据需要选择合适的函数来进行输出操作。更多关于fprintf和printf的相关文章详情请看本专题下面的文章。php中文网欢迎大家前来学习。

303

2023.11.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

738

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

219

2023.09.04

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

44

2026.03.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.2万人学习

C# 教程
C# 教程

共94课时 | 10.9万人学习

Java 教程
Java 教程

共578课时 | 78.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号