在Azure Function App中使用SQLAlchemy(MySQL)时函数部署后不显示问题

1. 数据库连接字符串格式与SSL要求不匹配 #

Heroku的DATABASE_URL通常以postgres://开头，但新版SQLAlchemy（1.4+）已不再支持该前缀，需改为postgresql://。另外，Azure PostgreSQL默认强制要求SSL连接，如果你的连接字符串未包含SSL参数，会直接导致连接失败。

解决：

• 替换连接字符串前缀：将postgres://改为postgresql://（若使用Heroku导出的URL）
• 在create_engine中添加SSL参数：

  engine = create_engine(DATABASE_URL, connect_args={"sslmode": "require"})
  

2. 模块顶级代码的日志未被正确捕获 #

你的数据库连接代码写在模块顶级（不在函数内部），Azure Functions启动阶段的模块初始化日志默认不会显示在函数实时日志流中，即便用logging.error记录了错误，也可能无法看到，导致你误以为没有报错。

解决：

• 将数据库初始化代码移至函数内部，这样日志会被正常捕获到Azure日志系统中
• 或者在模块开头设置日志级别为DEBUG，确保错误日志能输出：

  logging.basicConfig(level=logging.DEBUG)
  

3. 模块级别创建Session实例的风险 #

你在模块级别直接实例化session = Session()，Azure Functions的模块会被多个请求复用，长期持有数据库连接会引发连接泄漏、超时等问题，甚至在启动阶段就因连接失败导致函数无法加载。

解决：

• 仅在函数内部创建和使用Session，用完及时关闭：

  def main(req: func.HttpRequest) -> func.HttpResponse:
      session = Session()
      try:
          # 执行数据库操作
          return func.HttpResponse("Success")
      finally:
          session.close()
  

4. 依赖版本不一致 #

本地安装的SQLAlchemy或数据库驱动（如psycopg2）版本与Azure上的版本不匹配，可能引发兼容性问题。比如旧版SQLAlchemy支持postgres://前缀，新版不支持；或者psycopg2在Azure环境下需要安装psycopg2-binary而非psycopg2。

解决：

• 在requirements.txt中明确指定依赖版本，例如：

  sqlalchemy==2.0.23
  psycopg2-binary==2.9.9
  

• 确保本地和Azure使用相同版本的依赖进行测试

调试技巧 #

• 查看Azure Functions的启动日志：在Azure门户的函数应用中，进入「日志」->「平台日志」，查看启动阶段的错误信息，能帮你定位模块初始化时的异常
• 暂时移除try-except块，让异常直接抛出，Azure会在启动日志中显示详细错误信息，更便于排查问题

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