部署Flask应用至Google Cloud时遇libSM.so.6缺失的ImportError

这个错误是因为opencv-python依赖的系统库libSM.so.6没有安装——这个库属于X11窗口系统组件，默认在Google Cloud的无头环境（比如Compute Engine虚拟机、Cloud Run容器）里不会预装。下面给你两种常见场景的解决方法：

场景1：部署在Compute Engine虚拟机上 #

直接登录到你的VM实例，执行以下命令安装缺失的依赖库：

sudo apt-get update && sudo apt-get install -y libsm6 libxext6 libxrender-dev

安装完成后重启你的Flask应用，就能正常导入cv2了。

场景2：用Docker容器部署（Cloud Run/GKE等） #

如果是用Docker打包应用，需要在Dockerfile里添加系统依赖的安装步骤，放在安装Python依赖之前：

# 示例基于python官方轻量镜像
FROM python:3.9-slim

# 安装opencv所需的系统依赖
RUN apt-get update && apt-get install -y \
    libsm6 \
    libxext6 \
    libxrender-dev \
    && rm -rf /var/lib/apt/lists/*  # 清理缓存减小镜像体积

# 复制并安装Python依赖
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制应用代码并启动服务
COPY . .
CMD ["python", "app.py"]

更优方案：使用opencv-python-headless #

如果你不需要opencv的GUI功能（服务器环境基本都不需要），推荐直接用opencv-python-headless替代opencv-python——这个版本专门为无头环境打造，完全不需要依赖X11相关库：

• 修改你的requirements.txt，把opencv-python替换成opencv-python-headless
• 重新安装依赖（容器场景下重新构建镜像即可）

这种方式既能彻底解决问题，还能减少不必要的依赖，让应用更轻量化。

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