Java 路径白名单:字符串前缀为什么会误判目录边界

举报
yd_282952072 发表于 2026/11/13 14:14:42 2026/11/13
【摘要】 接口只允许访问 /srv/data 下的文件时,直接比较路径字符串的前缀,看起来很省事。但 /srv/data-other/report.txt 也以 /srv/data 开头,它属于另一个目录。下面是一个不访问文件系统的最小实验,运行环境为 macOS、Eclipse Temurin JDK 25.0.2。import java.nio.file.Path;public class Pre...

接口只允许访问 /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 编译运行;未使用线上文件或私人数据。

【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。