快速结论:在 Faster Whisper 依赖中自动装上 CTranslate2 4.6.3 后,原先在 4.6.2 上可用的 CUDA 设备(尤其 CUDA 12.8 相关环境)可能被排除,导致导入或运行时设备不可用。优先检查 ctranslate2 版本并回退到 4.6.2。
适用环境:Issue 已确认涉及 Faster Whisper 搭配 CTranslate2 4.6.2 与 4.6.3;正文提到 CUDA 12.8 设备排除。其余 Python、CUDA、显卡、PyTorch 版本未给出,不要臆测。
最快修复方案:暂无确认的一步修复方案。Issue 中维护者表示将把 ctranslate2 约束到 4.6.3 以下以保持兼容,但该修改尚未在讨论中验证发布。
注意事项:回退 ctranslate2 版本属于可优先尝试的处理方式,Issue 未给出正式发布版本或新约束号;若上游恢复兼容,后续可再放开上界。
问题场景
用户在使用 Faster Whisper 时,由于依赖链中的 ctranslate2 被自动升级到 4.6.3,原本在 4.6.2 下正常的 CUDA 设备环境出现问题。Issue 正文将其描述为一次来自 ctranslate2 依赖的“contamination bug”,并引用 CTranslate2 #1978,指出 4.6.3 补丁版本排除了 CUDA 12.8 下的设备。
报错原文
Ctranslate import break retro compatibility in 4.6.3
There is a contamination bug from ctranslate2 dependancy:
https://github.com/OpenNMT/CTranslate2/issues/1978
They decided to exclude device under CUDA 12.8 in 4.6.3 patch version.
The requirements of faster whisper lib should then block upgrade of current version to 4.6.2 to maintain retro compatibility.
原因分析
可能原因是 Faster Whisper 的依赖声明未限制 ctranslate2 的版本上界,安装或升级时拉取到 4.6.3。CTranslate2 4.6.3 对 CUDA 12.8 下的设备支持策略发生变化,会在导入或运行阶段破坏 4.6.2 上原本可用的设备行为。Issue 中维护者也确认,4.6.3 的 CUDA 12.8 设备排除会破坏在 4.6.2 上正常的配置。
环境排查
- 确认已安装的 ctranslate2 实际版本是否为 4.6.3。
- 确认 Faster Whisper 的 requirements 或包元数据中对 ctranslate2 是否设置了上界约束。
- 确认当前使用的 CUDA 版本,Issue 特别提到 CUDA 12.8 设备被排除。
- 确认显卡与驱动是否能被 CTranslate2 4.6.2 正常识别。
- Python、PyTorch 版本在 Issue 中未给出,无需按特定版本排查。
解决步骤
- 先查看当前环境中的 ctranslate2 版本,确认是否为 4.6.3。
- 可优先尝试将 ctranslate2 回退到 4.6.2,以恢复 4.6.2 下正常的 CUDA 设备行为。
- 在项目中显式限制 ctranslate2 版本,避免安装或升级 Faster Whisper 时被带动升级到 4.6.3。
- 关注 Faster Whisper 后续版本是否像维护者所说的那样,在 requirements 与包元数据中收紧 ctranslate2 的上界,并记录 changelog。
- 如果希望在不兼容的 ctranslate2 已安装时收到警告,Issue 中维护者提到可增加运行时警告,但该行为尚未作为默认方案确认。
验证方法
回退或调整版本约束后,重新安装依赖并确认 ctranslate2 不再是 4.6.3,而是在 4.6.2 或维护者之后指定的兼容范围内。随后重新导入 Faster Whisper 并运行原本失败的 CUDA 设备调用,确认设备能够正常识别与使用,即认为问题已绕过。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


