PojavLauncher Fabric模组加载黑屏问题分析与解决方案

问题现象描述

在PojavLauncher中运行Minecraft 1.20.1 Fabric版本时，当添加Sodium、Lithium或Embeddium等优化模组后，游戏启动会出现黑屏现象。而基础Fabric环境（无模组状态）可以正常运行。

根本原因分析

从错误日志中可以明确看到三个关键错误信息：

1. 文件权限拒绝错误：java.io.FileNotFoundException: ... (Permission denied)
2. 模组分析失败：Error analyzing [/storage/.../mods/xxx.jar]
3. 模组解析异常：ModResolutionException: Mod discovery failed!

这些问题表明：

• Android存储权限限制导致Fabric加载器无法读取模组文件
• 文件系统权限配置不当造成JAR文件访问被拒绝
• 模组加载过程中断引发游戏初始化失败

技术背景

在Android系统上，应用对存储空间的访问受到严格限制：

1. Scoped Storage机制限制应用只能访问特定目录
2. 运行时权限需要动态申请
3. 文件URI访问需要特殊处理

Fabric加载器在尝试分析模组JAR时：

1. 需要读取ZIP文件内容
2. 使用RandomAccessFile进行随机访问
3. 需要完整的文件系统权限

解决方案

方法一：使用内置目录管理

1. 启动PojavLauncher
2. 点击"Open Game Directory"按钮
3. 将模组文件移动到建议的游戏目录中
4. 确保目录路径不包含特殊字符或空格

方法二：权限检查与配置

1. 确认已授予PojavLauncher存储权限
2. 检查模组文件是否完整下载
3. 验证文件路径是否符合Android存储规范

方法三：替代方案

1. 使用PojavLauncher内置的模组管理器
2. 考虑使用Forge版本替代Fabric
3. 尝试较低版本的模组组合

预防措施

1. 始终通过启动器界面管理模组文件
2. 避免手动修改游戏目录结构
3. 定期清理旧版本模组文件
4. 优先使用经过验证的模组组合

技术建议

对于开发者而言，可以考虑：

1. 实现更友好的权限申请流程
2. 增加模组加载失败的错误提示
3. 优化文件访问异常处理机制
4. 提供模组兼容性检查功能

总结

Android平台上的Java环境与桌面端存在显著差异，特别是在文件系统访问方面。通过正确管理模组文件位置和权限配置，可以解决大多数Fabric模组加载问题。建议用户遵循启动器的推荐目录结构，并注意模组之间的兼容性关系。