Java 文件遍历遇软链接循环时，JVM 主动抛出 FileSystemLoopException 作为保护机制；应通过 NOFOLLOW_LINKS 禁用自动跟随，或用 toRealPath() 配合路径集去重来规避，而非依赖异常捕获。
Java 中文件遍历遇到软链接循环时，不会真正陷入 CPU 层面的死循环，而是由 JVM 主动检测并抛出 FileSystemLoopException 中断操作——它本质是保护机制，不是 bug。关键在于“提前识别、主动规避”，而非等异常发生再捕获。
看异常消息快速定位闭环路径
一旦抛出 FileSystemLoopException，别急着 try-catch，先读清楚异常字符串：
- 消息格式通常是：
java.nio.file.FileSystemLoopException: /a/b/c → /a/b，箭头右侧就是该软链接指向的目标路径 - 调用
e.getFile()可拿到触发异常的那个链接路径（比如/a/b/c） - 接着用
Files.readSymbolicLink(Paths.get("/a/b/c"))读出目标，再对目标重复执行此操作，直到某次读出的路径已在之前出现过——这就还原出了完整闭环链
代码中禁用自动跟随软链接
最简单有效的防御方式，就是不让遍历逻辑进入软链接：
- 用
Files.walk(path, FileVisitOption.NOFOLLOW_LINKS)替代默认行为（默认会跟随） - 这样所有软链接都被当作普通文件处理，不会解析其目标，自然避开闭环风险
- 缺点是无法访问链接指向的真实内容；如需访问，应改用
Files.walkFileTree()配合自定义SimpleFileVisitor
手动维护已访问路径集做去重
若必须解析软链接并访问真实路径，需在遍历时主动防重：
立即学习“Java免费学习笔记（深入）”；
- 在
preVisitDirectory方法中，调用path.toRealPath()获取规范路径（注意包裹 try-catch，因目标可能不存在） - 用一个
Set<Path>缓存所有已访问过的toRealPath()结果 - 每次进入新目录前检查该规范路径是否已存在，若存在则跳过（
FileVisitResult.SKIP_SUBTREE），并记录警告日志
上线前用命令行批量扫描风险链接
把问题挡在运行时之外：
- 查所有软链接：
find /target -type l -exec ls -la {} \; 2>/dev/null - 查悬空链接（常是环路前兆）：
find /target -xtype l - 模拟 Java 行为走几层：
find -L /target -maxdepth 3 -name "*" 2>/dev/null | head -20，若输出大量重复或跳转突兀（如从/app/logs突然到/app/config），大概率存在环
