ModuleNotFoundError: No module named ‘_soundfile_data’

问题场景

用户在 Docker 中运行 LiteLLM Proxy，通过 ghcr.io/berriai/litellm-database:main-stable 镜像搭建服务，并在 UI 中配置 OpenAI 的 gpt-4o-transcribe-diarize 音频转录模型。配置完成后点击 Test Connect 按钮，随即报错无法加载 libsndfile.so，更进一步导致 ModuleNotFoundError: No module named '_soundfile_data'。后续评论也确认在 main-v1.80.15.rc.2 与 main-v1.80.15-nightly 镜像上同样存在此问题。

报错原文

litellm.APIConnectionError: APIConnectionError: OpenAIException - cannot load library 'libsndfile.so': libsndfile.so: cannot open shared object file: No such file or directory
stack trace: Traceback (most recent call last):
  File "/usr/lib/python3.13/site-packages/soundfile.py", line 161, in <module>
    import _soundfile_data  # ImportError if this doesn't exist
    ^^^^^^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named '_soundfile_data'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/usr/lib/python3.13/site-packages/soundfile.py", line 170, in <module>
    raise OSError('sndfile library not found using ctypes.util.find_library')
OSError: sndfile library not found using ctypes.util.find_library

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/usr/lib/python3.13/site-packages/litellm/main.py", line 5659, in atranscription
    calculated_duration = calculate_request_duration(file)
  File "/usr/lib/python3.13/site-packages/litellm/litellm_core_utils/audio_utils/utils.py", line 152, in calculate_request_duration
    import soundfile as sf

原因分析

根本原因是 litellm-database 这个镜像在构建时没有安装音频处理所需的系统库 libsndfile。Python 的 soundfile 模块依赖该动态库，而 LiteLLM 在每次处理音频转录请求时，会调用 calculate_request_duration 计算音频时长，函数内部 import soundfile，最终因找不到 libsndfile.so 而失败。这里的 _soundfile_data 只是 soundfile 模块内部加载库失败前的表象，真正的缺失项是系统级共享库 libsndfile.so。

环境排查

• 确认当前运行的 LiteLLM 镜像完整 tag，例如 ghcr.io/berriai/litellm-database:main-stable 对应的 LiteLLM 版本。
• 检查容器内是否存在 libsndfile.so 或 libsndfile.so.1：docker exec <container> ldconfig -p | grep sndfile
  

  参考来源

  BerriAI/litellm #18598

  

  AI 工具推荐

  想把多个 AI 模型放在一个入口？

  GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

  了解 GamsGo AI

  推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

  这个方案解决了吗？

  解决了还没有