软件无法运行/闪退/报错

大部分的问题都能在这个章节解决。
分成下载/安装问题、运行中闪退、运行库问题、Agent 长时间启动无反应、资源加载问题以及连接问题六类。
其中大部分问题都属于运行库问题和连接问题。

下载/安装问题

完整 M9A 软件压缩包命名格式为 "M9A-平台-架构-版本.zip"，其余均为无法单独使用的“零部件”，请仔细阅读。
在大部分情况下，您需要使用 x64 架构的 M9A，即您需要下载 M9A-win-x86_64-vXXX.zip，而非M9A-win-aarch64-vXXX.zip。

运行中闪退

当您有独立显卡且开启GPU加速时，可能会出现该问题。

解决方案:

使用 MaaPiCli： 将 config/maa_pi_config.json 里的 gpu 字段的值改成 -2，即禁用 GPU。

使用 MFAAvalonia：在[设置]-[性能设置]里将[启用GPU加速]取消勾选

运行库问题（Windows）

打开软件有以下特征时，说明需要更新运行库：

1. 启动 MFAAvalonia 时，出现

   You must install .NET Desktop Runtime to run this application.

2. 在使用 MaaPiCli 时，出现 应用程序错误：应用程序无法正常启动

以上一般便是运行库问题，需要更新运行库

若更新运行库后仍然无法解决，以上两种启动方法均闪退，且在当前目录不生成任何日志文件，则是其它依赖相关问题。
请到项目Issues页面反馈。

Agent 长时间启动无反应（Windows）

使用通用 UI（如 MFAAvalonia）时，长时间无反应，或提示 ...No such file or directory，需要重新下载完整包。

资源加载问题

问题出现时提示资源加载失败。
解决方法是删除 M9A 所在的整个文件夹（如需保留配置，请先备份 config 目录），然后重新下载安装 M9A 。

连接问题

问题出现时提示连接模拟器时发生错误。
造成连接失败有很多原因，请按下面的步骤一步步尝试。

1. 确认 ADB 及连接地址正确

参阅 连接设置

提示

不要连到别的模拟器/设备去了！

2. 关闭现有 ADB 进程

关闭 M9A 后查找 任务管理器 - 详细信息 中有无名称包含 adb 的进程，如有，结束它后重试连接。

3. 正确使用多个 ADB

当 ADB 版本不同时，新启动的进程会关闭旧的进程。因此在需要同时运行多个 ADB，如 MAA、 Android Studio、Alas、手机助手时，请确认它们的版本相同。

4. 更换触控方式

部分模拟器（如蓝叠中国、夜神等）可能 adb 版本较低，可以尝试更换 adb 或更换触控方式。

5. 改用 MaaPiCli

若您使用 MFAAvalonia 连接失败，请尝试改用 MaaPiCli。使用说明

6. 避免游戏加速器

部分加速器在启动加速和停止加速之后，都需要重启 MAA、ADB 和模拟器再连接。

同时使用 UU 加速器 和 MuMu 12 可以参考官方文档。

7. 重启电脑

重启能解决 97% 的问题。（确信

8. 换模拟器

请参阅 模拟器和设备支持。
通常来说，建议使用 MuMu12 或雷电9。

文件下载速度慢

1. 使用Mirror酱更新
2. 求助群友/到网上查询相关办法。

日志黄字提示

启动任务时，日志中可能出现类似以下的黄字提示:

获取 resource/manifest.json失败:("Connection aborted.
ConnectionResetError(10054,'远程主机强迫关闭了一个现有的连接。；None,10054,None))
未获取到任何可用的资源清单

这通常是因为网络问题无法连接到 api.1999.fan 所致。这只影响小部分数据的热更，只要及时更新 M9A 到最新版就没有影响，可以忽略。

遇到其它黄字日志，同样通常不影响运行，建议先忽略。若频繁出现并影响功能可按下方方式反馈。

其他问题

当您确定已经阅读过以上常见问题并尝试自行解决无果后，您可以：

1. 到项目Issues页面 ，根据模板要求提交相关材料。
2. M9A 交流群 QQ 群：175638678，在阅读完群公告后提问。
3. 在下面提问