Azure Function App中DELETE参数化查询报错：未声明标量变量@agencyId

核心问题定位 #

你遇到的报错本质是参数没有被正确绑定到SQL查询语句中，虽然SELECT/INSERT能正常工作，但DELETE语句的参数传递逻辑可能存在格式或调用方式的差异。以下是具体排查思路和修复方案：

修复方案1：修正参数传递格式（最可能解决问题） #

你的代码中使用sql.query(query, parameters)传递参数，但对于mssql库，这种方式的参数格式要求与你当前的写法不匹配。可以通过两种方式修正：

方式A：给参数名添加@前缀

修改参数数组中name属性，添加@符号，与查询语句中的变量名完全一致：

const parameters = [
    { name: '@agencyId', sqlType: sql.Int, value: parseInt(req.body.AGENCY_ID, 10) } // 同时确保值为整数类型
];
const query = 'DELETE FROM Agency_Defs WHERE AGENCY_ID = @agencyId;';

方式B：使用Request对象绑定参数（更可靠的标准写法）

推荐使用Request对象显式绑定参数，这也是mssql库官方推荐的参数化查询方式，能避免格式匹配问题：

try {
    // 创建连接池（建议复用，不要每次请求都重新连接）
    const pool = await sql.connect(dbConfig);
    const request = pool.request();
    
    // 绑定参数：第一个参数是变量名（不带@，查询语句中用@+变量名）
    request.input('agencyId', sql.Int, parseInt(req.body.AGENCY_ID, 10));
    
    const result = await request.query(query);
    
    // DELETE操作返回rowsAffected，而非查询结果集，建议返回受影响行数
    context.res = {
        body: {
            message: "Delete operation completed",
            affectedRows: result.rowsAffected[0]
        }
    };
} catch (error) {
    context.res = {
        status: 500,
        body: error.message
    };
}

额外排查点 #

1. 确保参数值类型正确
   检查req.body.AGENCY_ID是否为整数类型，如果是字符串，需要用parseInt(req.body.AGENCY_ID, 10)转换，避免类型不匹配导致参数绑定失败。

2. 避免重复创建数据库连接
   当前代码每次请求都调用sql.connect(dbConfig)，容易导致连接泄漏或性能问题。建议复用连接池，比如将连接池初始化放在函数外部：

   // 函数外部初始化连接池，复用连接
   const poolPromise = sql.connect(dbConfig);
   
   module.exports = async function (context, req) {
       // ... 其他逻辑 ...
       try {
           const pool = await poolPromise;
           const request = pool.request();
           // ... 绑定参数并执行查询 ...
       } catch (error) {
           // ... 错误处理 ...
       }
   }
   

3. 检查mssql库版本兼容性
   确认你使用的mssql库版本是否与SELECT/INSERT时一致，部分旧版本对DELETE语句的参数绑定逻辑存在差异，建议升级到最新稳定版。

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