容器化含PYODBC的Flask应用时ODBC Driver 17无法打开的问题

1. 校验ODBC驱动配置文件 #

• 执行odbcinst -j确认系统读取的ODBC配置文件路径（通常是/etc/odbcinst.ini）
• 打开配置文件，确保驱动条目与实际安装路径完全匹配，示例：

  [ODBC Driver 17 for SQL Server]
  Description=Microsoft ODBC Driver 17 for SQL Server
  Driver=/opt/microsoft/msodbcsql17/lib64/libmsodbcsql-17.10.so.2.1
  UsageCount=1
  

• 若路径不匹配，手动修改为驱动实际安装路径（可通过find / -name "libmsodbcsql-*.so"查找）

2. 修复驱动依赖缺失 #

• 执行ldd /opt/microsoft/msodbcsql17/lib64/libmsodbcsql-17.10.so.2.1检查驱动库的依赖项，标记未找到的库
• 针对Debian/Ubuntu系镜像，安装缺失依赖：

  apt-get install -y libssl-dev libkrb5-dev libgssapi-krb5-2
  

• 注意：不同版本驱动依赖的libssl版本可能不同，旧版驱动需安装libssl1.1，新版对应libssl3

3. 确保环境变量生效 #

• 避免仅在Dockerfile中设置ENV LD_LIBRARY_PATH，改用启动脚本加载变量：
  1. 创建start.sh脚本：

     #!/bin/bash
     export LD_LIBRARY_PATH=/opt/microsoft/msodbcsql17/lib64:$LD_LIBRARY_PATH
     exec python app.py
     

  2. 给脚本添加执行权限：chmod +x start.sh
  3. Dockerfile中替换启动命令：

     ENTRYPOINT ["./start.sh"]
     

4. 验证连接字符串准确性 #

• 确保连接字符串中的驱动名称与odbcinst.ini内的名称完全一致，示例：

  conn_str = (
      "DRIVER={ODBC Driver 17 for SQL Server};"
      "SERVER=your-sql-server;"
      "DATABASE=your-db;"
      "UID=username;"
      "PWD=password"
  )
  

• 在容器内运行最小测试脚本，排除应用代码干扰：

  import pyodbc
  try:
      conn = pyodbc.connect(conn_str)
      print("连接成功")
  except Exception as e:
      print(f"错误详情: {str(e)}")
  

5. 调整Docker镜像构建顺序 #

• 将ODBC驱动安装步骤放在Python依赖安装之前，避免构建缓存导致驱动未被正确安装，示例Dockerfile结构：

  FROM python:3.9-slim
  
  # 先安装系统依赖和ODBC驱动
  RUN apt-get update && apt-get install -y --no-install-recommends \
      curl gnupg2 unixodbc-dev libssl-dev libkrb5-dev \
      && curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add - \
      && curl https://packages.microsoft.com/config/debian/11/prod.list > /etc/apt/sources.list.d/mssql-release.list \
      && apt-get update && ACCEPT_EULA=Y apt-get install -y msodbcsql17 \
      && apt-get clean && rm -rf /var/lib/apt/lists/*
  
  # 设置环境变量
  ENV LD_LIBRARY_PATH=/opt/microsoft/msodbcsql17/lib64:$LD_LIBRARY_PATH
  
  # 再安装Python依赖和复制应用代码
  WORKDIR /app
  COPY requirements.txt .
  RUN pip install --no-cache-dir -r requirements.txt
  COPY . .
  
  ENTRYPOINT ["./start.sh"]
  

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