Amazon Linux AMI上Flask应用连接MSSQL数据库的配置问题

哥们，我之前帮朋友搞定过一模一样的问题——在AWS Elastic Beanstalk的Linux实例上部署Flask连MSSQL，踩过不少FreeTDS配置的坑，给你整理一套亲测有效的步骤，应该能解决你的困扰：

首先得明确：在Linux环境下，你之前用的pyodbc依然能用！很多过时教程的问题出在驱动版本或者配置细节没做对，下面是我验证过的最新流程：

一、通过.ebextensions自动安装依赖 #

千万别手动去改EB实例的配置，毕竟EB会自动扩容，新实例会回到初始状态。我们用.ebextensions让EB部署时自动装包：

1. 在你的Flask项目根目录新建.ebextensions文件夹，然后创建01_install_dependencies.config文件，内容如下：

packages:
  yum:
    freetds: []
    freetds-devel: []
    unixODBC: []
    unixODBC-devel: []

commands:
  01_symlink_freetds:
    command: ln -s /usr/lib64/libtdsodbc.so.0 /usr/lib64/libtdsodbc.so

这个配置会自动安装FreeTDS和unixODBC，关键是最后那条软链接命令——很多人配置失败就是因为少了这一步。

二、配置ODBC连接文件 #

同样用.ebextensions来配置odbcinst.ini和odbc.ini，避免手动修改系统文件：

新建.ebextensions/02_configure_odbc.config，内容：

files:
  "/etc/odbcinst.ini":
    mode: "000644"
    owner: root
    group: root
    content: |
      [FreeTDS]
      Description = FreeTDS Driver for Linux & MSSQL
      Driver = /usr/lib64/libtdsodbc.so
      Setup = /usr/lib64/libtdsS.so
      FileUsage = 1

  "/etc/odbc.ini":
    mode: "000644"
    owner: root
    group: root
    content: |
      [MSSQLConnection]
      Driver = FreeTDS
      Server = 你的MSSQL服务器地址（比如xxx.database.windows.net）
      Port = 1433
      Database = 你的数据库名
      UID = 数据库用户名
      PWD = 数据库密码
      TDS_Version = 7.3  # 这个版本适配MSSQL 2016+，旧版本可以换成7.2/7.1

⚠️ 敏感信息（比如密码）别直接写在配置里！更安全的方式是用EB的环境变量存储，后面代码里直接读取就行。

三、Flask代码里的连接逻辑 #

不用换库，还是用你熟悉的pyodbc，两种连接方式任你选：

方式一：用ODBC数据源名（简单直接） #

import pyodbc

def get_db_connection():
    # 直接用刚才在odbc.ini里定义的数据源名
    conn = pyodbc.connect('DSN=MSSQLConnection')
    return conn

方式二：读取环境变量连接（更安全，推荐） #

先去EB控制台的「配置」->「软件」里添加环境变量：MSSQL_SERVER、MSSQL_DB、MSSQL_USER、MSSQL_PWD，然后代码里这样写：

import os
import pyodbc

def get_db_connection():
    server = os.environ.get('MSSQL_SERVER')
    database = os.environ.get('MSSQL_DB')
    username = os.environ.get('MSSQL_USER')
    password = os.environ.get('MSSQL_PWD')
    # 直接构造连接字符串，不用依赖系统配置文件
    conn_str = f'DRIVER={{FreeTDS}};SERVER={server};PORT=1433;DATABASE={database};UID={username};PWD={password};TDS_Version=7.3'
    conn = pyodbc.connect(conn_str)
    return conn

四、测试排坑 #

把配置文件和Flask代码打包部署到EB后，如果还是连不上，先查这几点：

• 看EB日志：控制台里选你的环境，「日志」->「请求完整日志」，搜odbc或pyodbc的错误信息，大概率能找到问题
• 检查MSSQL的安全组：是否允许EB实例的IP段访问1433端口？如果是云数据库（比如Azure SQL），要确认是否开放了对应IP访问权限

另外你提到想找「原生」方法——其实在Linux上，pyodbc搭配FreeTDS就是最主流的方案，微软官方也推荐这个组合。微软自己的Linux ODBC驱动也能用，但配置更复杂，FreeTDS足够稳定，没必要折腾。

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