Azure Function连接SQL数据库失败排查与解决求助

一、先补全错误日志（核心前提） #

当前日志仅显示失败无细节，先获取完整错误信息：

• 在Azure门户Function App的监控 > 日志中，切换到日志查询，运行以下语句提取详细错误：

  traces
  | where message contains "Error occurred:"
  | order by timestamp desc
  

• 修改代码catch块，输出完整错误栈：

  catch (err) {
      context.log.error('Full error:', JSON.stringify(err, Object.getOwnPropertyNames(err)));
      context.res = {
          status: 500,
          body: `Error: ${err.message}\nStack: ${err.stack}`
      };
  }
  

  调用函数后，500响应会包含具体错误信息，便于定位问题。

二、验证环境变量配置 #

• 进入Function App的配置 > 应用程序设置，核对以下变量：
  • DB_SERVER格式必须为xxx.database.windows.net（不要加端口或额外后缀）
  • DB_USER如果是SQL认证，直接填用户名；若用Entra ID认证则需对应邮箱/服务主体ID（当前代码为SQL认证格式）
  • 手动复制变量值到SSMS等工具测试，确认账号密码能正常登录目标数据库

三、排查依赖包兼容性 #

• 在Kudu控制台（Function App > 高级工具 > 进入Kudu），运行npm list mssql查看当前包版本
• 根据Function App的Node.js版本适配：Node.js 18+用mssql@9.x，Node.js 16用mssql@8.x，执行npm install mssql@指定版本后重启Function App
• 确认Kudu的node_modules目录下存在mssql及其依赖，缺失则手动运行npm install

四、核对网络与权限设置 #

• 检查SQL Server的防火墙和虚拟网络：
  • 确认勾选允许Azure服务和资源访问此服务器
  • 将Function App的所有出站IP地址（在Function App > 概述中复制全部）添加到防火墙规则
  • 若Function App在虚拟网络内，需确认VNet对等或服务端点配置正确
• 你设置的Entra管理员对当前SQL认证代码无效，若要改用Entra ID认证，需修改代码配置：

  const config = {
      server: process.env.DB_SERVER,
      database: process.env.DB_DATABASE,
      authentication: {
          type: 'azure-active-directory-default'
      },
      options: {
          encrypt: true
      }
  };
  

  同时给Function App的系统分配身份添加SQL数据库的DB Contributor或Reader角色。

五、修正连接配置细节 #

• 显式指定端口port: 1433，避免端口解析问题
• 尝试关闭enableArithAbort，部分版本的mssql与SQL Server对此参数存在兼容性问题：

  options: {
      encrypt: true,
      enableArithAbort: false
  }
  

六、测试最小化连接逻辑 #

简化代码排除干扰，仅保留核心连接逻辑：

const sql = require('mssql');

module.exports = async function (context, req) {
    try {
        const config = {
            user: process.env.DB_USER,
            password: process.env.DB_PASSWORD,
            server: process.env.DB_SERVER,
            database: process.env.DB_DATABASE,
            port: 1433,
            options: {
                encrypt: true
            }
        };
        await sql.connect(config);
        context.res = { status: 200, body: "Connected successfully" };
    } catch (err) {
        context.res = { status: 500, body: JSON.stringify(err) };
    }
};

调用该简化函数，根据返回的错误信息定位具体问题。

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