PojavLauncher安卓版Mod安装权限问题分析与解决方案

问题现象

在PojavLauncher安卓版运行Fabric模组包时，用户反馈新安装的模组无法正常加载。具体表现为游戏启动时卡在黑屏界面或直接崩溃，日志中显示"Permission denied"错误。该问题在Fabric 1.20.1和1.21.1版本中均有出现。

错误分析

从技术日志中可以发现关键错误信息：

java.io.FileNotFoundException: /storage/emulated/0/Android/data/net.kdt.pojavlaunch.debug/files/custom_instances/.../mods/freecam-fabric-modrinth-1.3.0+mc1.21.jar (Permission denied)

这表明游戏客户端尝试访问模组文件时被系统拒绝了权限。这种情况通常发生在以下场景：

1. 文件路径不正确
2. Android存储权限限制
3. 文件系统权限设置问题

根本原因

Android 11及以上版本引入了作用域存储限制，第三方应用无法直接访问其他应用的私有目录。PojavLauncher作为沙盒应用，其数据目录受到严格保护。

当用户通过外部文件管理器(如ZArchiver)将模组文件复制到游戏目录时，可能导致文件所有权和权限设置不正确，使得PojavLauncher进程无法读取这些文件。

解决方案

推荐方案：使用内置功能安装模组

1. 启动PojavLauncher
2. 选择目标游戏实例
3. 点击"打开游戏目录"按钮
4. 将模组文件直接放入弹出的文件管理器中的mods文件夹

这种方法可以确保文件权限正确设置，避免跨应用访问问题。

替代方案：手动修复权限

如果已经通过外部方式安装了模组：

1. 使用支持root权限的文件管理器
2. 导航到PojavLauncher的数据目录
3. 确保mods文件夹及其内容具有正确的读写权限(通常应为rw-rw----)
4. 将文件所有者改为PojavLauncher的应用用户ID

预防措施

1. 避免使用第三方文件管理器直接操作应用私有目录
2. 定期检查游戏目录权限设置
3. 在Android设置中确保PojavLauncher具有存储权限
4. 考虑使用PojavLauncher内置的模组管理功能

技术背景

Android的存储访问框架(SAF)和分区存储机制限制了应用间的文件共享。PojavLauncher作为游戏启动器，需要特别注意：

• 应用沙盒边界
• 文件URI权限授予
• 内容提供者机制

理解这些机制有助于开发者更好地设计文件交互流程，也能帮助用户避免常见的权限问题。

总结

PojavLauncher中的模组加载问题主要源于Android的存储权限限制。通过使用正确的文件操作方法，可以避免"Permission denied"错误，确保模组正常加载。未来版本的PojavLauncher可能会进一步优化模组管理流程，简化用户操作。