Java 路径白名单:字符串前缀为什么会误判目录边界
接口只允许访问 /srv/data 下的文件时,直接比较路径字符串的前缀,看起来很省事。但 /srv/data-other/report.txt 也以 /srv/data 开头,它属于另一个目录。
下面是一个不访问文件系统的最小实验,运行环境为 macOS、Eclipse Temurin JDK 25.0.2。
import java.nio.file.Path;
public class PrefixDemo {
public static void main(String[] args) {
Path base = Path.of("/srv/data");
Path candidate = Path.of("/srv/data-other/report.txt");
System.out.println(candidate.toString().startsWith(base.toString()));
System.out.println(candidate.startsWith(base));
}
}
实际输出:
true
false
两次调用的比较对象不同。String.startsWith 判断字符前缀;Path.startsWith 按路径组成部分比较,data-other 与 data 是不同的目录名。Oracle 的 Path API 文档描述了这种路径比较方式。
不过,把字符串比较换成 Path.startsWith,还不能直接宣布文件访问安全。
传入 ../outside.txt 时,可以先把输入与允许目录组合,再做 normalize,检查规范化路径是否仍以允许目录为前缀。这能处理词法层面的父目录跳转,但 normalize 不会读取文件系统,也不会解析符号链接。
本地实验另建了两个隔离目录 allowed 和 outside,在 outside 写入无敏感内容的测试文件,再在 allowed 内创建指向 outside 的符号链接。访问 allowed/link/note.txt 时,词法规范化后的路径仍位于 allowed 下,解析真实路径后却指向 outside。这两项检查在本次实验中都得到了预期结果。
对于已经存在的目标,toRealPath 可以用于解析真实路径,再与允许目录的真实路径比较。这与单纯消除 .. 不同;目标不存在、权限不足时也需要处理失败。
还要留意检查和打开之间的时间差。如果不可信方能在检查后替换目录或符号链接,先检查再读取仍可能有并发替换风险。新增文件也不能直接套用要求目标已存在的做法。生产代码需要结合目录写权限、文件打开方式和业务场景处理,不能把上面的前缀比较当成完整的安全文件访问组件。
这个实验说明,字符串相似、路径层级和真实文件位置是三个不同的问题。校验落在哪一层,决定了它实际证明了什么。
本文由 AI 协助整理,示例代码及路径边界实验已在本地 JDK 25.0.2 编译运行;未使用线上文件或私人数据。
- 点赞
- 收藏
- 关注作者
评论(0)