filesystemloopexception 表明文件遍历时遭遇软链接闭环，需从路径链排查而非代码循环；通过异常消息、readlink、find -l 等命令定位环路，代码中记录 torealpath 并检测重复，上线前用 find -xtype l 和图分析预检。
遇到 FileSystemLoopException，说明 Java 正在遍历文件树时撞上了软链接构成的闭环（比如 /a/b → /c、/c → /a），JVM 主动中断以避免卡死。这不是代码逻辑死循环，而是路径结构引发的系统级保护行为——排查要从“路径链”入手，而非检查 while 或 for。
看异常消息定位环路起点
异常文本里藏着关键线索：
- 消息格式通常是：
java.nio.file.FileSystemLoopException: /a/b/c → /a/b，箭头右侧是软链接指向的目标路径 - 调用
exception.getFile()可拿到触发异常的那个链接路径（即最后被解析的/a/b/c） - 再用
Files.readSymbolicLink(Paths.get("/a/b/c"))确认目标；接着对目标路径重复读取链接，直到出现重复路径，就还原出完整环（如：/a/b/c → /a/b → /a/b/c）
用命令行快速验证软链接结构
不启动 Java 程序也能初步判断：
-
find /target/path -type l -exec ls -la {} \; 2>/dev/null：列出所有软链接及其目标 -
readlink -f /target/path/some-link：展开为绝对规范路径，观察是否回绕到已访问目录 -
find -L /target/path -maxdepth 3 -name "*" 2>/dev/null | head -20：用-L强制跟随链接走几步，若输出突然大量重复或跳转异常，大概率存在环
代码中临时加日志辅助追踪
在遍历逻辑里插入轻量路径记录，比等崩溃更早发现问题：
- 使用
SimpleFileVisitor自定义遍历时，在preVisitDirectory中打印path.toRealPath()（注意 try-catch） - 维护一个
Set<string></string>存已见过的toRealPath().toString()，每次进入前检查是否已存在——若存在，立即记录当前路径并跳过，这能帮你捕获环的“入口点” - 避免只 catch 异常后静默忽略；至少打 WARN 日志，含路径、时间、线程名，便于后续聚合分析
上线前批量扫描可疑链接
把风险挡在运行时之外：
- 用
find /app/home -xtype l找出所有“悬空或可能成环”的软链接（-xtype l表示链接目标不存在，常是环的前兆） - 结合
ls -lR | grep " -> " | awk '{print $1,$9,$11}'提取链接关系，人工或脚本构建简单有向图，跑一次 DFS 检环 - 对部署目录执行
realpath --relative-to=. linkname，若返回含../多层跳转，且目标落在同级或上级目录内，就要重点审核
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
