PojavLauncher中Mod加载失败问题的分析与解决方案

问题现象

在PojavLauncher项目中，部分Android用户反馈在1.21版本Forge环境下加载Mod时出现启动崩溃。错误日志显示系统抛出AccessDeniedException异常，提示对mods目录下的jar文件没有访问权限。当不加载任何Mod时，游戏可以正常启动。

技术背景分析

该问题主要涉及Android系统的文件权限管理和Java NIO的文件系统访问机制：

1. Android存储权限模型：自Android 11起引入了Scoped Storage机制，对应用访问外部存储进行了更严格的限制
2. ZIP文件系统访问：Java的ZipFileSystem在尝试访问受保护区域的压缩文件时会进行权限校验
3. Mod加载流程：Forge通过SecureJarHandler模块加载Mod时，会尝试建立文件系统映射

根本原因

问题核心在于文件操作方式不当导致权限校验失败。当用户通过文件管理器直接"剪切"Mod文件到mods目录时：

• 文件可能保留了原始位置的安全上下文属性
• Android的存储访问框架(SAF)可能未正确更新文件所有权
• ZIP文件系统无法验证跨存储区域的文件访问权限

解决方案

推荐方案

1. 复制而非剪切：安装Mod时始终使用"复制"操作而非"剪切"
2. 二次打包法：
   • 将Mod文件先压缩为ZIP格式
   • 再解压到目标mods目录
3. 权限检查：确保PojavLauncher已获得存储访问权限

技术实现原理

通过重新打包操作可以：

• 重置文件的安全上下文属性
• 确保文件所有权归属当前应用
• 使ZIP文件系统能够正确验证访问权限

预防措施

开发者可考虑在后续版本中：

1. 实现Mod安装时的权限自动修复机制
2. 增加对文件所有权的预检查
3. 提供更友好的错误提示引导用户正确操作

影响范围

该问题主要影响：

• Android 11及以上系统版本
• 通过外部文件管理器安装Mod的情况
• 使用Forge/Fabric等需要Jar扫描的Mod加载器

通过正确的文件操作方式，用户可以避免此类权限问题，确保Mod正常加载。