技术参考
Eden 密钥缺失、固件安装失败怎么办？「Encryption keys are missing」「Firmware installation failed」报错解决
要点
- 安卓「Encryption keys are missing」（密钥缺失）和电脑版「Decryption keys are missing」（缺少解密密钥）都是还没装 prod.keys：装上 prod.keys，电脑版装完要重启 Eden。
- 安卓「Firmware installation failed」（固件安装失败）：固件 ZIP 里只要有一个不是 .nca 的文件（包括多套一层文件夹）就判失败。ZIP 打开后要直接就是 nca 文件。
- 「Keys failed to initialize」（密钥初始化失败）是 keys 文件无效、不完整或太旧，要重新导出；「Verify your keys file has a .keys extension」是文件名不对，改回 prod.keys。
- 电脑版要先装 keys、重启 Eden，再装固件；keys 不能比固件旧，否则开 Home Menu 会报「Firmware Corrupted」。
- 安卓装固件时闪出「Fatal Error」（致命错误），社区经验多是存储权限问题；驱动管理器的「Error during Fetch」（获取过程中出错）是连不上 GitHub。
目录
Eden 装 keys、固件时报错，最常见的是三件事：还没装 prod.keys（Encryption keys are missing / Decryption keys are missing，中文界面是「密钥缺失」「缺少解密密钥」），keys 文件名或内容不对（Keys failed to initialize、Verify your keys file has a .keys extension），以及安卓版固件 ZIP 的结构不对（Firmware installation failed，固件安装失败）。 修法分别是：装上 prod.keys 并重启 Eden；把文件名改回 prod.keys，内容有问题就重新导出；重新打包固件 ZIP，让它打开后直接就是 .nca 文件。下面按电脑版、安卓版逐条列出原文，截至 2026 年 11 月 1 日（Eden master 源码）。
报错速查表
| 报错原文（英文界面） | 中文界面 | 意思 | 怎么修 |
|---|---|---|---|
Encryption keys are missing | 密钥缺失 | 安卓版还没装 prod.keys | 向导或设置里「安装 prod.keys 文件」 |
Decryption keys are missing. Install them now? | 缺少解密密钥。现在安装吗？ | 电脑版还没装 prod.keys | 点 Yes 选 prod.keys，重启 Eden |
Keys failed to initialize / Decryption Keys failed to initialize | 密钥初始化失败 | keys 文件无效、不完整或太旧 | 重新导出 prod.keys |
Verify your keys file has a .keys extension and try again. | 请确保密钥文件具有.keys扩展名后重试。 | 文件名不对 | 改回 prod.keys |
Firmware installation failed | 固件安装失败 | 安卓：ZIP 里有不是 .nca 的文件 | ZIP 里只放 nca 文件 |
Install decryption keys and restart Eden before attempting to install firmware. | 在尝试安装固件之前先安装解密密钥并重启 Eden。 | 电脑版先装了固件 | 先装 keys，重启，再装固件 |
Firmware Corrupted | 固件已损坏 | keys 比固件旧，或固件坏了 | keys 换新；必要时重新导出固件 |
Fatal Error（装文件时） | 致命错误 | 安卓：解压或复制出错 | 社区经验：打开存储权限 |
Error installing file(s) to NAND | 向 NAND 安装文件时失败 | 装更新 / DLC 时没 keys 或文件无效 | 先装 keys；文件重新导出 |
Error during Fetch | 获取过程中出错 | 驱动管理器连不上 GitHub | 换网络、稍后再试，或手动导入驱动 zip |
装好以后开游戏才报的错是另外几类：安卓的「Your ROM is encrypted」见 Your ROM is encrypted 报错解决，电脑版的「Error while loading ROM! (0007-XXXX)」见 0007 错误码对照表。
Eden 电脑版（Windows / Linux / Mac / Steam Deck）
Eden 电脑版每次启动都会检查 keys，所以缺 keys 时一打开就会弹窗，不用等到开游戏。
| 原文 | 什么时候出现 | 原因 | 怎么修 |
|---|---|---|---|
Derivation Components Missing / Decryption keys are missing. Install them now?（缺少派生组件 / 缺少解密密钥。现在安装吗？） | 每次启动 | 没装 keys | 点 Yes，选 prod.keys（只能选这一个文件）；之后也可以用 Tools → Install Decryption Keys |
Install decryption keys and restart Eden before attempting to install firmware. | 装固件时 | 还没装 keys，或装了没重启 | 先装 keys，关掉 Eden 重新打开，再 Tools → Install Firmware |
Verify your keys file has a .keys extension and try again. | 装 keys 时 | 扩展名不对，例如 prod.keys.txt | 打开文件扩展名显示，改回 prod.keys |
Decryption Keys failed to initialize. Check that your dumping tools are up to date and re-dump keys.（密钥初始化失败。请检查您的转储工具是否为最新版本并重新转储密钥。） | 装 keys 时 | 文件读得到，但内容无效、不完整或太旧 | 重新导出一份新的 prod.keys |
Unable to read key directory, aborting / One or more keys failed to copy. | 装 keys 时 | 读不了所在文件夹，或复制失败，通常是权限或路径问题 | 把 prod.keys 放到一个普通文件夹（比如文档）再选 |
Unable to locate potential firmware NCA files | 装固件时 | 选的文件夹或 ZIP 里找不到固件的 nca 文件 | 确认选的是固件本身；Tools → Install Firmware 有 From Folder 和 From ZIP 两种，别选反 |
Firmware installation cancelled, firmware may be in a bad state or corrupted. Restart Eden or re-install firmware. | 装固件中途 | 取消了或中断了 | 重启 Eden，重新装一遍 |
Firmware Corrupted / Firmware reported as present, but was unable to be read. Check for decryption keys and redump firmware if necessary.（固件已损坏 / 固件已报告存在，但无法读取。如有必要请检查解密密钥并重新转储固件。） | 开 Home Menu、小程序时 | keys 和固件不配套（keys 比固件旧），或固件文件坏了 | keys 换成不比固件旧的版本；还不行重新导出固件 |
No firmware available / Firmware missing. Firmware is required to run certain games and use the Home Menu. | 开 Home Menu、小程序时 | 没装固件 | 装固件 |
Game Requires Firmware / This game may require firmware to function properly, and you don't have any installed. Please install firmware before launching, or press "OK" to launch anyways.（游戏需要固件） | 开游戏前 | 没装固件 | 装固件；也可以按 OK 直接开，但很多游戏会崩 |
Firmware integrity verification failed! | 校验固件时 | 固件文件损坏 | 重新导出固件 |
Eden 电脑版的 keys 存在数据目录的 keys 文件夹（Windows 是 %AppData%\eden\keys）。报错原因看不出来时，到 File → Open Eden Folders → Log Folder 打开日志 eden_log.txt，求助时附上它。
Eden 安卓版
安卓版的报错有官方中文翻译，下面同时列出英文和简体中文界面的原文。
| 英文原文 | 中文界面 | 原因 | 怎么修 |
|---|---|---|---|
Encryption keys are missing / Firmware and retail games cannot be decrypted | 密钥缺失 / 无法解密固件和商业游戏 | 没装 keys | 首次向导，或设置 → 管理 Eden 数据 → 安装 prod.keys 文件 |
Skip adding keys? / Valid keys are required to emulate retail games. Only homebrew apps will function if you continue. | 跳过添加密钥文件？ | 首次向导里跳过了 keys | 回去装 keys，否则只能运行自制软件 |
Failed to Install Keys / Keys failed to initialize. Check that your dumping tools are up to date and re-dump keys. | 密钥安装失败 / 密钥初始化失败。请检查您的转储工具是否为最新版本并重新转储密钥。 | keys 文件无效、不完整或太旧 | 重新导出 prod.keys |
Verify your keys file has a .keys extension and try again. | 请确保密钥文件具有.keys扩展名后重试。 | 文件名被改成 prod.keys(1)、prod (1).keys 之类 | 改回 prod.keys；同一个文件夹里有多个 keys 文件时容易选错 |
Firmware installation failed / Make sure the firmware nca files are at the root of the zip and try again. | 固件安装失败 / 请确保固件 nca 文件位于 zip 压缩包的根目录，然后重试。 | ZIP 里有不是 .nca 的文件（见下一节） | 重新打包 ZIP |
| Fatal Error（装固件、装 keys 时闪出） | 致命错误 | 解压或复制时出错 | 见下面「Fatal Error」一节 |
Error installing file(s) to NAND / Please ensure content(s) are valid and that the prod.keys file is installed. | 向 NAND 安装文件时失败 / 请确保附加内容的有效性，并且 prod.keys 密钥文件已安装。 | 装更新 / DLC 时还没装 keys，或文件无效 | 先装 keys；还不行重新导出这个文件 |
Installation of base games isn't permitted in order to avoid possible conflicts. | 为避免产生冲突，此功能不能用于安装游戏本体。 | 用「安装到 NAND」装了游戏本体 | 本体用「添加游戏文件夹」，NAND 安装只装更新和 DLC |
System Archive Not Found / %s is missing. Please dump your system archives. Continuing emulation may result in crashes. | 未找到系统档案 / %s 已丢失。请重新转储您的系统档案。继续模拟可能会导致崩溃。 | 游戏要用的固件组件不存在：没装固件或固件太旧 | 装或更新固件，keys 一起换新 |
| Game Requires Firmware | 游戏需要固件 | 没装固件 | 装固件 |
Fatal Error / A fatal error occurred. Check the log for details. Continuing emulation may result in crashes. | 发生致命错误。请查阅日志获取详细信息。继续模拟可能会导致崩溃。 | 游戏运行中出了未知错误 | 设置 → Share Debug Logs 导出日志排查 |
本页的安卓原文以 Eden 为准；Citron Neo 安卓版同属 yuzu 系，个别文字可能有出入。
固件 ZIP 为什么总是「Firmware installation failed」
根据 Eden 源码（InstallableActions.kt），安卓版装固件时会先把 ZIP 解压到缓存文件夹，再数一遍第一层：解压出来的条目总数和其中 .nca 文件的数量不一样，就直接判失败，子文件夹也算一个条目。所以下面这些都会失败：
- ZIP 里多套了一层文件夹（例如
Firmware 21.2.0/xxxx.nca）； - ZIP 里夹了说明文字、
.txt、.url或其他文件； - 一个 ZIP 里又套了一个 ZIP。
修法：把所有 nca 文件直接选中打包成一个 ZIP，打开 ZIP 第一层就是 nca 文件。在 Eden 里选这个 ZIP 文件本身，不要先解压。装成功后，Eden 会用新固件整个替换掉旧固件。
安卓装固件 / keys 时闪出「Fatal Error」
Eden 在解压或复制文件时抛出异常，就会弹「Fatal Error」（致命错误），提示里没有具体原因。
社区经验（三星 S22、Galaxy Tab S9 等机型的用户报告，不保证所有机型都适用）：这是存储权限问题。到系统设置的权限管理里找到「所有文件访问权限」（不同手机的菜单名不同），显示系统应用，给名为 External storage（外部存储）的系统组件打开权限，再回 Eden 重装。
「Error installing file(s) to NAND」和「不能安装本体」
Eden 官方文档说明，「安装到 NAND」（电脑版是 File → Install Files to NAND）是给单独的更新和 DLC 文件用的；游戏本体直接加进游戏列表就行。用它装本体会被拒绝，提示 Installation of base games isn't permitted in order to avoid possible conflicts.。
装更新或 DLC 时报 Error installing file(s) to NAND，先确认 prod.keys 已经装好；keys 装好了还报，多半是这个更新 / DLC 文件不完整，重新导出一份。
Citron Neo 电脑版
Citron Neo 电脑版用的是旧 yuzu 的写法，缺 keys 时弹：
Derivation Components Missing
Encryption keys are missing.
For support, please visit Help > Get Support (Discord) in the main emulation window.
所以英文搜「encryption keys are missing」会同时搜到 yuzu、Citron Neo 和 Eden 安卓版的结果，意思都一样：还没装 prod.keys。装法和 Eden 电脑版基本相同，装完重启。
版本要配套：keys 不能比固件旧
- keys 至少要和固件一样新。 keys 比固件旧时，固件能装进去，但读不出来，Eden 会报「Firmware Corrupted」，开游戏还会出现各种解密错误。主机升级系统后，keys 和固件要一起换。
- 固件也不是越新越好。 截至 2026 年 11 月 1 日，Citron Neo 官网写的是支持到 21.2.0；没有模拟器官方宣布完整支持 23.x 固件，Eden 关于 23.x 固件问题的 issue #4414 还没有关闭。
- 概念和各模拟器的存放位置见 prod.keys、title.keys 和固件是什么。
安卓驱动管理器：「Error during Fetch」和驱动安装失败
Eden 安卓版设置里的「GPU 驱动管理器」（GPU driver manager）也常报错。它和 keys、固件无关，但都是第一次设置时会碰到的，一并列出：
| 英文原文 | 中文界面 | 原因 | 怎么修 |
|---|---|---|---|
Error during Fetch / Failed to fetch | 获取过程中出错 / 获取失败 | Fetch 直接访问 api.github.com 拉驱动列表；网络连不上 GitHub，或短时间请求太多被限流（GitHub 未登录接口每小时 60 次） | 换个网络，或过一小时再试；也可以从驱动作者的 GitHub 发布页拿到驱动 zip，用 Install 导入（不要解压） |
Downloaded driver is empty, check your internet | 下载的驱动为空，请检查网络连接 | 下载中断 | 换网络重试 |
Driver installation failed / Failed to install %1$s driver, does your system support it? | 驱动安装失败 / 无法安装%1$s驱动，您的系统支持吗? | 不是骁龙手机（Mali、Xclipse 装不了 Turnip），或者选的 zip 不对 | 天玑、Exynos 手机只能用系统驱动；骁龙手机确认选的是驱动 zip 本身 |
Unsupported GPU / Your GPU does not support driver injection. Attempting to set custom drivers is not recommended. | GPU不支持 / 您的GPU不支持驱动注入。不建议设置自定义驱动。 | 同上，GPU 不支持换驱动 | 用 System Driver |
驱动怎么选、怎么换，见 安卓 Turnip 驱动说明。驱动换完开游戏报「初始化视频核心时发生错误」，见 Vulkan 和视频核心报错。
常见问题
Eden 提示 Encryption keys are missing（密钥缺失）怎么办？
这是 Eden 安卓版检测到还没装 prod.keys。在首次设置向导，或设置里的「管理 Eden 数据」（Manage Eden data）中点「安装 prod.keys 文件」（Install prod.keys），选择 prod.keys 即可，只能选这一个文件。电脑版对应的提示是「Decryption keys are missing. Install them now?」（缺少解密密钥。现在安装吗？），点 Yes 选 prod.keys，装完重启 Eden。
Eden 安卓版固件安装失败（Firmware installation failed）怎么办？
Eden 解压固件 ZIP 后，只要发现任何一个不是 .nca 的文件就判失败，多套一层文件夹也算。重新打包：ZIP 打开后直接就是固件的 nca 文件，没有子文件夹、没有其他文件，然后选这个 ZIP，不要先解压。
Eden 识别不了秘钥文件、提示密钥初始化失败怎么办？
先看提示原文。「Verify your keys file has a .keys extension」是文件名不对，常见的是被改成 prod.keys.txt 或 prod (1).keys，改回 prod.keys 再选。「Keys failed to initialize」是文件内容有问题：不完整、损坏或版本太旧，重新导出一份新的 prod.keys。
Eden 安卓装固件或 keys 时闪出 Fatal Error 是什么原因？
Eden 在解压或复制文件时出错就会弹「Fatal Error」。社区里三星 S22、Tab S9 等机型的用户报告是存储权限问题：在系统设置的「所有文件访问权限」里显示系统应用，给 External storage（外部存储）组件打开权限后就能装。这是社区经验，不保证所有机型都适用。
Eden 电脑版提示 Install decryption keys and restart Eden before attempting to install firmware？
意思是要先装解密密钥，并且重启 Eden，然后才能装固件。按 Tools → Install Decryption Keys 选 prod.keys，关掉 Eden 重新打开，再用 Tools → Install Firmware 装固件。
Error installing file(s) to NAND（向 NAND 安装文件时失败）是什么意思？
安装更新或 DLC 时失败。最常见的是还没装 prod.keys，或者更新 / DLC 文件本身无效。先装好 keys 再装；还不行就重新导出这个文件。游戏本体不能用「安装到 NAND」装，要用添加游戏文件夹。
Eden 驱动获取失败（Error during Fetch）怎么办？
安卓版「GPU 驱动管理器」的 Fetch 会直接访问 GitHub 的接口拉取驱动列表。网络连不上 GitHub，或者短时间内请求太多被 GitHub 限流（未登录每小时 60 次），都会报这个。换个网络或过一小时再试；也可以从驱动作者的 GitHub 发布页拿到驱动 zip，用驱动管理器的 Install 导入，不用解压。
Eden 提示 Firmware Corrupted（固件已损坏）怎么办？
固件装上了但读不出来，通常是 keys 比固件旧，或者固件文件坏了。把 keys 换成不比固件旧的版本；还不行就重新导出固件再装。