技术参考
龙神模拟器（Ryubing）报错 RYU-0001 / RYU-0002 / RYU-0003 怎么办？Keys not found、固件解析出错、MissingKeyException 解决方法（2026）
要点
- RYU-0001 = 找不到 prod.keys，RYU-0002 = 没装固件，RYU-0003 = 固件解析失败（通常是 keys 比固件旧），RYU-0004 = 路径下找不到游戏。Kenji-NX 电脑版用同一套错误码。
- RYU-0001 先看 prod.keys 是不是放在 Ryujinx 文件夹的 system 子文件夹里、文件名是不是正好叫 prod.keys，放对了还报就是 keys 文件本身有问题，要重新导出。
- RYU-0003 的修法是把 keys 和固件换成同一版本，keys 不能比固件旧。
- 日志里的 MissingKeyException（Missing NCA title key 等）和 KeyNotFoundException 'None' 都属于 keys 缺失或过旧，更新 prod.keys 和 title.keys。
- 2026 年下半年用 SDK 22.2 制作的部分新游戏，主程序用了新的 ZBIC 压缩，Ryubing 截至 2026-11-01 还读不了，这不是 keys 的问题；Eden Nightly 已经支持。
目录
**RYU-XXXX 是 Ryubing（龙神模拟器的社区延续版）启动或开游戏前做设置检查时弹出的错误码：RYU-0001 是找不到 prod.keys，RYU-0002 是没装固件，RYU-0003 是固件解析失败（通常是 keys 比固件旧），RYU-0004 是指定路径下找不到游戏。**最常见的修法是：把 prod.keys 放进 Ryujinx 文件夹的 system 子文件夹、文件名保持 prod.keys，再把 keys 和固件换成同一版本（keys 不能比固件旧）。Kenji-NX 电脑版用的是同一套错误码。截至 2026 年 11 月，还有一类「keys 没问题也打不开」的情况：2026 年下半年的部分新游戏用了新的压缩格式，Ryubing 还读不了，见最后一节。
报错原文长什么样
英文界面：
Ryujinx Error (RYU-0001)
RYU-0001: Keys not found.
Ryujinx was unable to find your "prod.keys" file.
For more information on how to fix this error, follow our Setup Guide.
简体中文界面：
Ryujinx 错误 (RYU-0001)
RYU-0001: 找不到密钥。
Ryujinx 模拟器找不到“prod.keys”密钥文件。
有关修复此错误的更多信息，可以查看我们的安装指南。
错误码的规则来自 Ryubing 源码：RYU- 后面是错误编号的四位十六进制。
错误码速查
| 错误码 | 英文原文 | 简中界面原文 | 什么时候弹 | 原因 | 怎么修 |
|---|---|---|---|---|---|
| RYU-0001 | Keys not found. / Ryujinx was unable to find your "prod.keys" file. | 找不到密钥。/ Ryujinx 模拟器找不到“prod.keys”密钥文件。 | 启动、装固件时 | 没有 prod.keys、放错文件夹、文件名不对、keys 无效 | 放进 system 文件夹并重启；放对了还报就重新导出 keys |
| RYU-0002 | Firmware not found / Ryujinx was unable to find any firmwares installed. | 未安装系统固件 / Ryujinx 模拟器未安装 Switch 系统固件。 | 打开商业游戏时（.nro / .nso 自制程序不检查） | 没装固件 | Actions → Install Firmware 安装固件 |
| RYU-0003 | Firmware parsing error / Ryujinx was unable to parse the provided firmware. This is usually caused by outdated keys. | 固件文件解析出错 / Ryujinx 模拟器无法解密当前固件，一般是由于使用了旧版的密钥导致的。 | 安装固件时 | keys 比固件旧 | keys 和固件换成同一版本 |
| RYU-0004 | Application not found / Ryujinx couldn't find a valid application at the given path. | 找不到游戏程序 / Ryujinx 模拟器在所选路径中找不到有效的游戏程序。 | 用快捷方式或命令行打开游戏时 | 文件被移走、改名或盘符变了 | 重新添加游戏目录、重建快捷方式 |
| RYU-DEAD | Unknown error / An unknown error occured! | 未知错误 / 出现未知错误！ | 不定 | 未归类的错误 | 看日志（见下文） |
RYU-0001：Keys not found（找不到密钥）
Ryubing 在数据目录的 system 文件夹里找 prod.keys。按这个顺序排查：
- 位置：菜单 File → Open Ryujinx Folder（简中界面「打开 Ryujinx 系统目录」），进
system子文件夹，prod.keys（有的话连同 title.keys）放在这里。Windows 默认数据目录是%appdata%\Ryujinx。 - 文件名：必须正好是
prod.keys。Windows 默认隐藏扩展名，文件可能实际叫prod.keys.txt；浏览器重复保存还会变成prod(1).keys。 - 重启：放好后完全关掉 Ryubing 再打开，它启动时才会重新检查。
- 用菜单安装：新版 Ryubing 有 Actions → Install Keys（简中「安装密匙」），可以选
.keys文件或文件夹。如果提示An invalid Keys file was found in ...（「在 … 发现了一个无效的密匙文件」），说明文件内容无效。 - 放对了还报：keys 文件本身有问题（不完整、损坏或不是 prod.keys）。Ryubing 官方 issue #405 里，用户装完 keys 再装固件仍报 RYU-0001，协作者的答复就是从自己的 Switch 重新导出 keys。
RYU-0002：Firmware not found（未安装系统固件）
Ryubing 打开商业游戏前会检查有没有固件，没有就报 RYU-0002；自制程序（.nro / .nso）不做这个检查。
- 用 Actions → Install Firmware → XCI or ZIP...（简中「安装系统固件」→「XCI 或 ZIP...」）选固件 ZIP，也可以选 Folder... 从文件夹安装。有的版本这一项在 Tools 菜单下。安装成功后右下角显示系统版本。
- 选的文件不是固件时会提示
A valid system firmware was not found in ...（「在路径 … 中找不到有效的 Switch 系统固件」）。 - 打开的是未裁剪的实体卡带 XCI 时，Ryubing 会主动问
Would you like to install the firmware embedded in this game?（「要安装游戏文件中内嵌的系统固件吗？」），选是就会用卡带里自带的固件。
RYU-0003：Firmware parsing error（固件文件解析出错）
说明文字已经写了原因：keys 比固件旧。固件要用 prod.keys 解密，旧 keys 里没有新固件需要的那一代密钥。
- 修法：keys 和固件换成同一版本，keys 至少要和固件一样新。主机升级系统后，两样要一起重新导出。
- keys 和固件版本一样还报：目前没有官方说明原因。可以先把 Ryubing 更新到最新版，再重新导出 keys 后装一次。
- 固件也不是越新越好，模拟器对新固件的支持会滞后，见 prod.keys、title.keys 和固件详解。
RYU-0004：Application not found（找不到游戏程序）
快捷方式或命令行指向的路径下没有游戏文件，常见于文件被移走、改名，或者移动硬盘的盘符变了。重新添加游戏目录，再从游戏列表打开或重建快捷方式。
日志里的报错：游戏闪退或卡住时看
很多 keys、固件问题不弹 RYU 窗口，而是游戏一开就退出。官方 FAQ 的做法：菜单 File → Open Logs Folder（简中「打开日志目录」），打开最新、最大的那个日志文件，搜下面的关键字。
| 日志原文（关键部分） | 意思 | 怎么修 |
|---|---|---|
LibHac.Common.Keys.MissingKeyException: Missing NCA title key. | 缺这款游戏、更新或 DLC 的 title key，或 keys 太旧 | 重新导出并更新 prod.keys 和 title.keys |
MissingKeyException: Unable to decrypt title key. | 同上 | 同上 |
MissingKeyException: Unable to decrypt NCA section. | 同上 | 同上 |
System.Collections.Generic.KeyNotFoundException: The given key 'None' was not present in the dictionary. | 官方 FAQ 归为 keys 问题 | 同上 |
System.IO.FileNotFoundException: System archive with titleid 0100000000000823 was not found on Storage BuiltInSystem. | 固件太旧，游戏要用的系统档案不存在（titleid 因游戏而异） | keys 和固件一起更新 |
Ryujinx has encountered an error: System update title was not found in the firmware package. | 选的文件不是固件 | 重新选固件 ZIP 或未裁剪的卡带 XCI |
System.ArgumentException: An item with the same key has already been added.（打不开设置或闪退） | 固件注册目录里有残留；如果报错里提到 PTC，则是 PPTC 缓存坏了 | 清空 Ryujinx 文件夹下 bis\system\Contents\registered 的内容后重装固件；提到 PTC 时右键游戏 → Cache Management → Queue PPTC Rebuild（缓存管理 → 清除 PPTC 缓存文件） |
Loader LoadNca: No ExeFS found in NCA（卡在启动） | 游戏文件导出的方式不对 | 重新导出游戏文件 |
NPDM file not found, using default values! … Unable to load: Could not find Main NCA | 把更新包当游戏打开了 | 打开本体；更新用右键游戏 → Manage Updates（管理更新）挂上 |
弹窗 No applications found in selected file.（简中「未发现应用」） | 选中的文件里没有游戏本体（更新、DLC 或不完整的文件） | 打开本体；更新和 DLC 用右键菜单的 Manage Updates / Manage DLC 挂上 |
keys 和固件的关系、各文件放在哪，见 prod.keys、title.keys 和固件详解；闪退、黑屏等不是 keys 引起的问题，见常见问题排查。
keys 没问题也打不开：2026 年下半年的新游戏
截至 2026 年 11 月 1 日，Ryubing 有两个和新游戏有关的已知问题，换 keys、换固件都解决不了：
| 日志原文 | 是什么 | 现状 |
|---|---|---|
System.ArgumentOutOfRangeException: srcOffset ('-38731') … Lz4.Decompress … NsoReader.ReadSegmentImpl | 用 SDK 22.2 制作的游戏，主程序（main）换成了新的 ZBIC 压缩（Zstandard 的变体），Ryubing 仍按旧的 LZ4 去解，游戏一开就失败 | 官方 issue #492（2026-09-01，Canary 1.3.351、固件 22.1.0 上报告），未修复 |
GuestBrokeExecutionException，客机调用栈里有 TlsHeapCentral::LockMutexSlow_ | 同一批 SDK 22.2.0 游戏在 sdk 模块初始化时中止 | 官方 issue #493（2026-09-01），未修复 |
日志里出现这两种字样，可以先改用 Eden 的 Nightly 版：Eden 在 2026-09-27 的提交里加入了 ZBIC 解压（Switch 22.0+），稳定版 v0.2.1（2026-06-01）还没有。Eden 自己的报错见 Error while loading ROM（0007）错误码表。
Kenji-NX 和 MeloNX
- Kenji-NX 电脑版的报错对话框代码和 Ryubing 相同，同样显示
RYU-XXXX，本页的修法都适用。Kenji-NX 安卓版的报错文字本站没有核实。 - MeloNX 2.4 起基于 Ryubing 重写，keys、固件不配套的原理一样，但 iPhone 上弹的是 MeloNX 自己的提示，见 MeloNX 报错大全。
常见问题
龙神模拟器报 RYU-0001 Keys not found 怎么办？
RYU-0001 表示 Ryubing 找不到 prod.keys。用菜单 File → Open Ryujinx Folder 打开数据目录，把 prod.keys（和 title.keys）放进 system 子文件夹，文件名必须正好是 prod.keys，然后重启模拟器。也可以用 Actions → Install Keys 选文件安装。放对了还报，说明 keys 文件无效，要从主机重新导出。
已经装了 prod.keys，装固件时还是提示 RYU-0001？
Ryubing 官方 issue #405 里就有这种情况：先装了 keys，再装固件仍报 RYU-0001。项目协作者的答复是从自己的 Switch 重新导出 keys。另外检查一下文件名，Windows 默认隐藏扩展名，文件可能实际叫 prod.keys.txt 或 prod(1).keys。
RYU-0003 固件文件解析出错是什么原因？
Ryubing 的说明文字是「This is usually caused by outdated keys」，即 keys 比固件旧。把 keys 和固件换成同一版本即可，keys 至少要和固件一样新。版本一样还报的情况目前没有官方说明，可以先把 Ryubing 更新到最新版、重新导出 keys 再装一次。
龙神模拟器 RYU-0002 未安装系统固件怎么解决？
打开商业游戏前 Ryubing 会检查固件，没装就报 RYU-0002。用 Actions → Install Firmware → XCI or ZIP 选固件 ZIP 安装，成功后右下角会显示系统版本。如果打开的是未裁剪的实体卡带 XCI，Ryubing 会主动询问是否安装游戏里内嵌的固件，选是即可。
日志里有 MissingKeyException: Missing NCA title key 怎么办？
这是缺这款游戏、更新或 DLC 的 title key，或者 keys 太旧。Ryubing 官方 FAQ 把它和 Unable to decrypt title key、Unable to decrypt NCA section、KeyNotFoundException 'None' 归为同一类，修法都是重新导出并更新 prod.keys 和 title.keys。
龙神模拟器提示 No applications found in selected file？
选中的文件里没有游戏本体，常见是把更新包或 DLC 当游戏打开了，或者文件不完整。打开游戏本体；更新用右键游戏 → Manage Updates（管理更新）挂上，DLC 用 Manage DLC（管理 DLC）。简中界面显示的是「未发现应用」。
2026 年的新游戏在 Ryubing 上一打开就闪退，keys 和固件都是新的？
看日志里有没有 ArgumentOutOfRangeException: srcOffset 和 Lz4.Decompress、NsoReader 字样。有的话是新 SDK 的 ZBIC 压缩问题（官方 issue #492，截至 2026-11-01 未修复），换 keys 没用。可以改用已支持 ZBIC 的 Eden Nightly。
Kenji-NX 也会弹 RYU 错误码吗？
会。Kenji-NX 是 Ryujinx 系的分支，电脑版的报错对话框代码和 Ryubing 一样，也显示 RYU-XXXX，修法相同。Kenji-NX 安卓版的报错文字本站没有核实。