FileSystemLoopException是程序遍历目录时因软链接闭环（如A→B→C→A）触发的保护性异常，源于Java NIO、Python os.walk()等主动检测机制，旨在防止无限递归；需通过readlink -f查重、find -L限深、ls -l溯源识别；编程中应禁用自动解链，手动维护已访问路径集规避；修复须删、改或隔离问题链接；预防需规范创建流程并定期扫描。
遇到 FileSystemLoopException，说明程序在遍历目录时撞上了软链接构成的闭环——比如 A → B → C → A 这类路径链。这不是 Linux 内核报错，而是 Java NIO（如 Files.walk()）、Python 的 os.walk() 或某些备份/扫描工具主动抛出的保护性异常，目的是防止无限递归耗尽栈空间或卡死进程。
识别循环：先看链接结构，再查路径走向
软链接本身不“知道”自己是否成环，它只存一个字符串路径。是否成环取决于你从哪开始走、怎么解析相对路径、是否做路径规范化。关键判断点有三个：
- 用
readlink -f展开绝对路径，观察是否出现重复路径段（例如两次出现/var/www/app） - 用
find -L遍历时加-maxdepth限制深度，若某层突然大量跳转，极可能进入环路 - 对每个软链接执行
ls -l，检查目标是否又指向了上级或同级某个已访问过的路径
编程中规避：控制遍历逻辑，不依赖系统自动解链
多数语言默认开启“跟随软链接”，但你可以关掉它，改为主动、受控地处理：
- Java NIO：用
Files.walk(path, FileVisitOption.NOFOLLOW_LINKS)，之后对每个Path手动调用Files.isSymbolicLink()和Files.readSymbolicLink()，维护已访问路径集合（Set），每次展开前查重 - Python：用
os.scandir()替代os.walk()，对每个DirEntry判断.is_symlink()，再用os.path.realpath()获取规范路径并缓存比对 - Shell 脚本：结合
find /path -type l -printf '%p -> %l\n'输出所有链接关系，再用 awk 构建图结构，用 DFS 检测环
修复源头：删、改、隔离，三选一
运行时规避是权宜之计；真正解决问题得回到文件系统层面清理：
-
删：确认软链接无业务用途，直接
rm linkname。这是最干净的方式 -
改：用
ln -sf /new/target linkname指向真实终点，避开中间跳转。注意目标必须存在且可访问 -
隔离：把可疑目录设为遍历白名单外区域，或在挂载时加
noexec,nosuid,nodev等选项降低风险
预防机制：建立软链接管理习惯
循环不是偶然发生的，往往源于缺乏约束的协作环境：
- 创建软链接前，用
realpath --relative-to=.校验目标是否落在当前树内 - 统一使用绝对路径创建软链接（避免
../引发的隐式跳转） - 定期用脚本扫描：
find /opt -type l -exec sh -c 'readlink -f "$1" | grep -q "^$1"' _ {} \; -print，找出指向自身的链接
