从Node.js编写的Azure Functions连接Azure SQL DB失败求助

我之前刚好踩过这个坑，折腾了好一阵才把Node.js版Azure Functions连Azure SQL的问题搞定，给你梳理几个关键排查点和解决方案：

1. 先确认连接字符串的配置和读取方式 #

Azure SQL的ODBC连接字符串格式要准确，标准格式应该是：

Driver={ODBC Driver 18 for SQL Server};Server=tcp:<你的服务器名>.database.windows.net,1433;Database=<你的数据库名>;Uid=<登录账号>;Pwd=<登录密码>;Encrypt=yes;TrustServerCertificate=no;Connection Timeout=30;

另外要注意在Azure Functions应用设置里的存储细节：

• 如果把连接字符串放在应用程序设置的Connection Strings区域，记得把类型选成Custom，不然系统会自动给键名加前缀（比如SQLAzure类型会加SQLCONNSTR_），读取的时候要对应上，比如你设置的键是AzureSQLConn，那读取的时候就是process.env.SQLCONNSTR_AzureSQLConn（SQLAzure类型）或者process.env.AzureSQLConn（Custom类型）。
• 更省心的方式是直接把连接字符串放在常规设置的环境变量里，这样直接用process.env.AzureSQLConn就能读取，不容易出错。

2. 换用更适合Azure环境的数据库包 #

如果你之前用的是需要本地编译的ODBC驱动包（比如msnodesqlv8），在Azure Functions的托管环境里很容易出问题，因为缺少编译依赖。更推荐用纯JavaScript实现的mssql包（基于tedious），不需要编译，兼容性更好。
先安装依赖：

npm install mssql

3. 调整后的可运行示例代码 #

给你一个HTTP触发函数的完整示例，用mssql包实现：

const sql = require('mssql');

module.exports = async function (context, req) {
    try {
        // 从环境变量读取连接字符串
        const connStr = process.env.AzureSQLConnection;
        if (!connStr) {
            throw new Error("请在应用设置中配置AzureSQLConnection环境变量");
        }

        // 初始化连接池
        await sql.connect(connStr);
        
        // 执行查询（替换成你的SQL语句）
        const queryResult = await sql.query('SELECT TOP 5 * FROM YourTableName');
        
        context.res = {
            status: 200,
            body: {
                success: true,
                data: queryResult.recordset
            }
        };
    } catch (err) {
        context.log.error("数据库操作失败:", err);
        context.res = {
            status: 500,
            body: {
                success: false,
                error: err.message,
                stack: err.stack
            }
        };
    } finally {
        // 确保关闭连接池，避免资源泄漏
        await sql.close();
    }
};

4. 排查网络和权限问题 #

• 去Azure门户的SQL服务器页面，检查防火墙和虚拟网络设置，一定要勾选“允许Azure服务和资源访问此服务器”，不然Azure Functions没法连到SQL服务器。
• 确认你的SQL登录账号有目标数据库的访问权限，比如至少要有db_datareader权限（只读操作），或者db_datawriter+db_datareader（读写操作）。

5. 查看详细错误日志 #

你没贴具体的报错信息，建议去Azure Functions的监控->日志流里看完整的错误堆栈，比如是连接超时、认证失败还是驱动加载失败，这能帮你快速定位核心问题。

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