Docker容器（Python 2.7）安装PyAudio失败求解决方案

问题背景 #

在Python 2.7环境的Docker容器中，尝试通过requirements.txt安装PyAudio以配合SpeechRecognition库使用时，容器构建失败；移除PyAudio后构建正常。执行pip install pyaudio时触发核心错误：

无法找到满足setuptools>=61.0要求的版本（Python 2.7支持的setuptools最高版本为44.1.1）

错误原因 #

新版本PyAudio（如0.2.12）的构建依赖要求setuptools>=61.0，但setuptools从50.x版本开始不再支持Python 2.7，而Python 2.7已停止维护，无法安装高版本setuptools。

解决方案 #

1. 使用Python 2.7兼容的PyAudio版本

PyAudio 0.2.11是最后一个支持Python 2.7的稳定版本，无需依赖高版本setuptools。在requirements.txt中指定版本：

SpeechRecognition
PyAudio==0.2.11

2. 完善Dockerfile的系统依赖与工具版本

PyAudio依赖PortAudio系统库，同时需要固定pip和setuptools到Python 2.7兼容的版本。以下是完整的Dockerfile示例（基于Debian/Ubuntu镜像）：

FROM python:2.7-slim

# 安装PyAudio编译所需的系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    portaudio19-dev \
    python-dev \
    gcc \
    && rm -rf /var/lib/apt/lists/*

# 升级pip到Python2.7支持的最高版本，固定setuptools到兼容版本
RUN pip install --upgrade pip==20.3.4 setuptools==44.1.1

# 安装Python依赖包
COPY requirements.txt .
RUN pip install -r requirements.txt

# 后续容器配置指令...

3. 验证安装效果

构建容器后，进入容器执行以下命令确认安装成功：

python -c "import pyaudio; import speech_recognition; print('PyAudio与SpeechRecognition安装成功')"

内容的提问来源于stack exchange，提问作者braino