filesystemloopexception 是启用 follow_links 后遍历中检测到软链接循环时抛出的 unchecked ioexception。它由 files.walkfiletree 内部环路检测触发，需通过禁用 follow_links、设 maxdepth 或在 visitfilefailed 中捕获并跳过子树来处理。
遇到 FileSystemLoopException，说明你在用 Files.walkFileTree() 遍历目录时，碰到了软链接（symbolic link）构成的循环路径。NIO.2 默认不跟随软链接，但一旦你显式启用了 FOLLOW_LINKS 选项，而文件系统中又存在 A → B → A 这类链接链，就会在遍历时检测到闭环，抛出这个运行时异常。
为什么会出现 FileSystemLoopException
这个异常不是由用户代码直接 throw 的，而是 Files.walkFileTree() 在启用 FOLLOW_LINKS 后，内部通过维护已访问路径的集合做环路检测——当准备进入一个已被访问过的物理路径（inode 级别）时，就判定为循环，立即中断并抛出 FileSystemLoopException。
它属于 IOException 的子类，但注意：它是 unchecked exception（继承自 RuntimeException），所以编译器不要求强制捕获，但实际运行中必须处理，否则程序崩溃。
避免循环的两种主流做法
不推荐强行 catch 并忽略 —— 这会掩盖真实问题，可能导致重复处理、无限递归或资源耗尽。应优先从设计上规避：
- 默认不启用 FOLLOW_LINKS：这是最安全的做法。NIO.2 默认跳过软链接（即把链接本身当作普通文件处理），自然不会陷入循环。除非业务明确需要解析链接目标，否则无需开启该选项。
-
启用 FOLLOW_LINKS 时配合深度限制：使用带四个参数的重载方法：
Files.walkFileTree(start, options, maxDepth, visitor)。
将maxDepth设为合理值（如10或20），可防止因深层嵌套链接导致的失控遍历，也能间接规避多数人为构造的环。
捕获并优雅降级的实用方式
若必须跟随链接且无法控制外部链接结构（例如扫描用户指定的任意路径），应在 visitFileFailed 中识别该异常并跳过，而非让整个遍历终止：
- 继承
SimpleFileVisitor<path></path>，重写visitFileFailed方法； - 检查异常是否为
FileSystemLoopException实例； - 如果是，打印警告日志，返回
FileVisitResult.SKIP_SUBTREE（跳过当前链接指向的整个子树）或SKIP_SIBLINGS（仅跳过当前项及其兄弟）； - 其他 IOException 按需处理（如权限不足、文件损坏等）。
验证路径是否含软链接环的小技巧
开发调试阶段，可用命令行快速探查：
- Linux/macOS：
find -L /path/to/dir -maxdepth 5 -type l -exec ls -la {} \;查看深层软链接； - Windows（PowerShell）：
Get-ChildItem -Recurse -Attributes ReparsePoint列出所有符号链接； - 再结合
readlink -f或Resolve-Path追踪目标，人工判断是否存在闭环。
