userprincipalnotfoundexception 是非受检异常，虽继承自 ioexception 但不强制 try-catch；它表示用户名无法解析为系统用户主体，常见于跨平台身份映射失败，与权限无关。
UserPrincipalNotFoundException 本身不是受检异常，它是 IOException 的子类，而 IOException 是受检异常 —— 但 Java 从 NIO.2 开始将 UserPrincipalNotFoundException 设计为**非受检异常（即运行时异常）**，继承链为：Throwable → Exception → IOException → UserPrincipalNotFoundException，但它**不强制要求 try-catch 或 throws 声明**。这一点常被误解。
跨平台权限映射为何容易触发该异常
核心问题不在“权限修改”，而在“用户名到系统用户主体的解析”是否可行：
- Linux/macOS 支持 POSIX 用户数据库，
lookupPrincipalByName("alice")可成功返回UserPrincipal - Windows 默认无 POSIX 用户主体机制，
getUserPrincipalLookupService()可能返回null或查不到任意用户名（包括当前登录用户），直接抛出UserPrincipalNotFoundException - 即使在 Linux 上，若传入拼写错误、已删除或仅存在于 LDAP 但未同步到本地
/etc/passwd的用户名，也会触发此异常
为什么不能靠 throws 声明来“处理”它
因为它是 RuntimeException 的间接子类（尽管继承自 IOException，但 JDK 明确将其归为 unchecked）：
- 编译器不会强制你捕获或声明它
- 若未显式 try-catch，异常会向上冒泡，可能导致静默失败或服务中断
- 误以为它是受检异常而忽略处理，是跨平台文件所有者设置失败的常见原因
安全跨平台的所有者设置实践
不依赖用户名硬编码，改用运行时可确定的主体：
- 优先复用已有有效主体：用
Files.getOwner(path)获取当前所有者，再用于其他文件（避免查找） - Windows 下跳过 owner 设置：通过
System.getProperty("os.name").toLowerCase().contains("win")判断，改用AclFileAttributeView管理 ACL 权限 - 预检查再操作：对必须指定的用户名，先调用
lookupPrincipalByName(name)并捕获异常，失败时降级（如设为当前进程用户path.getFileSystem().getUserPrincipalLookupService().lookupPrincipalByName(System.getProperty("user.name"))）
小结：它不是权限异常，而是身份解析异常
这个异常和文件读写权限（如 AccessDeniedException）、ACL 所有权（如 NotOwnerException）无关，只说明“你写的用户名，系统根本不认识”。跨平台项目中，应默认它可能随时发生，而不是假设环境一致。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
