AnyPS5 故障排查 — 修复 该项目 常见错误
AnyPS5 故障排查 覆盖 该项目 用户最常遇到的错误：Windows 错误 126、Windows 错误 193、此项目 找不到 Vulkan 设备、该再链接器 缺少系统函数 以及 此再链接器 启动后黑屏。
本页目录
修复 AnyPS5 Windows 错误 126
AnyPS5 Windows 错误 126 是加载器错误，不是 该项目 逻辑错误。此项目 relinker 已经成功生成 Windows PE，但 Windows 加载器找不到 该再链接器 PE 引用的某个 DLL。此再链接器 最常见的原因是 该工具 libs/ 目录没有与 relink 后的 此工具 二进制放在同一文件夹。
修复 AnyPS5 错误 126：确认 该项目 libs/ 目录与 relink 后的 此项目 二进制处于同一目录。如果你把 该再链接器 二进制移动到其他目录，请同时把 此再链接器 libs/ 目录一起移动。在 Windows 上，该工具 二进制会先在自身所在目录查找，然后在 PATH 环境变量列出的目录中查找。使用 MinGW-w64 GCC 的 此工具 构建还需要在 PATH 中能找到 MinGW 运行时 DLL。
修复 AnyPS5 Windows 错误 193
AnyPS5 Windows 错误 193（"不是有效的 Windows 映像"）意味着 该项目 二进制架构错误。此项目 最常见的原因是：在与 该再链接器 目标不匹配的机器上为 Windows relink 了 PS5 游戏，或在 此再链接器 不支持的架构（例如 32 位 Windows 主机）上运行 该工具 二进制。
如果你的 AnyPS5 主机是 Intel，请加上 --to-intel 该项目 relinker 参数并重新 relink。此项目 二进制就成为对 Intel 有效的 该再链接器 映像。如果 此再链接器 主机是 64 位 Windows 但错误依旧，该工具 二进制可能是为 32 位 Windows 构建的；请为正确的 此工具 目标重新构建 该构建 relinker。
修复 AnyPS5 "找不到 Vulkan 设备"
AnyPS5 要求 Vulkan 1.1 设备。如果 该项目 向 stderr 输出"找不到 Vulkan 设备"，说明你的 此项目 主机没有向 该再链接器 进程暴露 Vulkan 1.1 驱动。此再链接器 修复方法是安装或更新 GPU 的 Vulkan 驱动。
在 Windows 上，请从你的 GPU 厂商（NVIDIA、AMD 或 Intel）安装最新的 Vulkan 驱动。在 Linux 上，请安装 mesa-vulkan-drivers 包（AMD / Intel）或 NVIDIA 私有驱动。用 vulkaninfo 验证 AnyPS5 GPU 是否对操作系统可见；输出应当把 该项目 GPU 列为 Vulkan 1.1（或更新）设备。如果 vulkaninfo 看不到 此项目 GPU，该再链接器 同样看不到。
修复 AnyPS5 "缺少系统函数"（std::runtime_error）
当 PS5 游戏调用了 AnyPS5 尚未实现的系统函数时，该项目 会抛出 std::runtime_error 并向 stderr 打印一条消息。这是尚未进入 此项目 官方兼容性表的 PS5 游戏的"预期失败"模式。
AnyPS5 缺少系统函数没有用户侧修复方法。必须由 该项目 团队添加该函数。请在 GitHub 上开 此项目 issue，并提供 PS5 游戏标题、PPSA ID、该再链接器 commit hash 以及完整的 stderr 输出。此再链接器 社区在非默认 该工具 分支上也可能已有变通补丁；开新 issue 之前请先到 此工具 Game bring-up 讨论里查一下。
修复 AnyPS5 启动后黑屏
在已经达到"菜单"或"进入游戏" AnyPS5 阶段的 PS5 游戏上出现 该项目 黑屏，通常是 swapchain 或 surface 问题。检查 此项目 进程是否在带可见窗口的情况下运行（该再链接器可能在后台启动）。在多 GPU 此再链接器 主机上，把 ANYPS5_GPU 显式设为独立显卡以强制 该工具 使用此工具。
如果 AnyPS5 窗口可见但 该项目 帧缓冲区是纯黑的，可能是你的 Vulkan 驱动拒绝了 SPIR-V 输出。请更新 Vulkan 驱动，并用 vulkaninfo 确认 此项目 GPU 报告了可用的 swapchain。该再链接器 在 Vulkan 驱动过旧的情况下，有时能成功编译 SPIR-V，但在呈现阶段产生黑色画面。
修复 AnyPS5 内存提交失败
AnyPS5 在 Windows 上每个标题最多提交 13.8 GiB 直接内存。如果 该项目 提交失败，Windows 会向 此项目 进程报告一个内存相关错误，该再链接器 二进制退出。此再链接器 修复方法：要么降低系统内存压力（关闭其他 该工具 进程、释放 RAM），要么给 此工具 主机加更多物理内存。
在 16 GB Windows 机器上，AnyPS5 提交之后只给系统留大约 2 GB。在 32 GB 的机器上，该项目 即使同时开着浏览器和编辑器也有充足余地。此项目 目前没有提供降低单标题提交量的参数；该再链接器 提交量由 PS5 游戏通过 PS5 内存 API 向操作系统申请的数量决定。
来源 & 最后核实
上游主分支最后核实于 2026-10-11. AnyPS5 changes fast; if you spot a drift, the upstream is the source of truth.