java中io流读取含空格或特殊字符的本地文件失败，根本原因是路径被url编码后未正确还原；应统一用uri解析路径、避免手动拼接、提前校验并创建父目录。
Java 中 IO 流读取本地文件时，路径含空格或特殊字符（如中文、%、#、[、]等）常导致 FileNotFoundException，根本原因不是文件真不存在，而是路径被 URL 编码后未正确还原，或构造 File 对象时传入了非法格式字符串。解决关键在于：**统一用 URI 解析路径、避免手动拼接、提前校验与创建目录**。
用 toURI().getPath() 替代 getResource().getPath()
从类路径加载资源时，getClass().getResource("xxx").getPath() 返回的字符串常含 %20（空格编码）、%E4%B8%AD（中文编码）等，直接传给 new FileReader() 会失败。
- ❌ 错误写法：
String path = MyClass.class.getResource("/conf/config.txt").getPath(); new File(path)（%20未解码） - ✅ 正确写法：
String path = MyClass.class.getResource("/conf/config.txt").toURI().getPath(); new File(path) - 注意：
toURI()可能抛URISyntaxException，需捕获处理；它自动将%xx和+还原为原始字符，且保留空格原貌
避免字符串拼接路径，改用 Paths.get() 或 File(…, …) 构造
手动拼接 "dir" + File.separator + "file.txt" 易出错，且无法处理编码或跨平台分隔符问题。
- 推荐使用
Paths.get(baseDir, "sub", "config.json")—— 自动处理斜杠、编码、平台差异 - 或使用
new File(parentDir, "filename.txt")，父目录File对象本身已解析过路径，更可靠 - 绝对不要用
"C:\data\my file.txt".replace("\", "/")这类“土办法”，对中文或%无效
路径存在性与父目录创建必须主动检查
FileNotFoundException 常因父目录根本不存在，而非文件本身缺失。IO 操作不会自动创建中间目录。
- 读取前检查：
File f = Paths.get("output/logs/app.log").toFile(); if (!f.getParentFile().exists() && !f.getParentFile().mkdirs()) { throw new RuntimeException("无法创建日志目录"); } - 写入前确保目录就绪，比依赖异常后提示更健壮
-
mkdirs()创建多级目录，mkdir()只建一级，易失败
对用户输入或外部路径做合法性过滤与清理
若路径来自配置文件、命令行参数或 Web 表单，需防范 ../ 路径遍历和非法字符。
- 用
Paths.get(input).normalize().toString()消除冗余..和. - 检查是否超出预期根目录范围，例如限制在
/app/data/下：if (!realPath.startsWith(expectedRoot)) throw new SecurityException("非法路径访问"); - 不建议用正则粗暴替换空格——可能误删有意义的空格；应走 URI 或 Path 解析流程
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
