GPU 测试列表是空的或缺 API 怎么办

想跑 GPU 测试，列表里却没有 OpenCL 或 Vulkan；或者某台机器干脆一个计算 API 都没有。API 可用性由驱动与系统组件决定，官方 FAQ 专门回答过这个问题。

API 缺失的三个来源

驱动没装好或太旧。计算 API 依赖显卡驱动的运行时组件。装了显卡但驱动只有基础显示功能（比如系统自带的通用驱动）时，OpenCL 与 Vulkan 的运行时可能根本不存在。先去显卡厂商渠道更新驱动。

官方版本不支持该 API 的当前形态。官方 FAQ 的原文思路：确认你手里的版本是否支持该 API——支持矩阵随版本演进（例如 Vulkan 在 Linux/ARM 上是 6.6 才加入的，见6.3 到 6.7 四年里补齐了哪些能力）。

无头环境的特例。官方 FAQ 点名过一个场景：在无显示器（无头）的 AMD 系统上用脚本跑 Vulkan，需要 2019 年 9 月之后发布的驱动版本，Vulkan 才会作为可用选项出现。服务器用户最常撞上这一条。

排查顺序

1. 更新显卡驱动到厂商最新版；
2. 确认软件版本支持目标 API（对照版本年表）；
3. 命令行用 --gpu-list 复查（用法见命令行参数全解）；
4. 无头机器特别检查驱动发布日期是否晚于官方提到的门槛；
5. 仍不可用则反馈官方（附设备与驱动版本）。

都不支持时的替代方案

个别集成显卡的老设备可能任何计算 API 都跑不动。这时 CPU 分数仍然完整有效——GPU Compute 本来就是可选测试，见CPU 测试与 GPU 计算测试各管哪一摊。

下一站

网络侧的问题：结果上传失败的排查。