R语言API通过ODBC调用MSSQL传参报错：硬编码正常传参500错误

排查修复步骤 #

• 核对参数绑定一致性：得保证#* @param IdA注解里的参数名和函数定义的参数名完全匹配，大小写、拼写都不能错，比如函数是function(IdA)，注解就不能写成Ida或者ID_A。
• 强制转换参数类型：Plumber默认传的是字符串类型，如果数据库里的ID是整数，必须显式转类型：IdA <- as.integer(IdA)，不然SQL查询时会因为类型不匹配报错。
• 用参数化查询替代字符串拼接：别直接用paste拼SQL语句，改用DBI的参数化查询，既能避免类型问题，还能防SQL注入：

  library(DBI)
  library(odbc)
  
  #* @get /fetch-data
  #* @param IdA 目标查询ID
  function(IdA) {
    # 转换参数为整数类型
    IdA <- as.integer(IdA)
    # 连接MSSQL（提前配置好ODBC数据源）
    con <- dbConnect(odbc::odbc(), "你的MSSQL数据源名")
    # 参数化查询语句
    query_str <- "SELECT * FROM 目标表名 WHERE id = ?"
    # 传入参数执行查询
    query_result <- dbGetQuery(con, query_str, params = list(IdA))
    # 关闭连接
    dbDisconnect(con)
    return(query_result)
  }
  

• 捕获错误日志定位问题：在代码里加tryCatch捕获错误，或者启动Plumber时开启日志，这样能看到具体报错原因：

  #* @get /fetch-data
  #* @param IdA
  function(IdA) {
    tryCatch({
      # 业务代码逻辑
      IdA <- as.integer(IdA)
      con <- dbConnect(odbc::odbc(), "你的MSSQL数据源名")
      query_str <- "SELECT * FROM 目标表名 WHERE id = ?"
      query_result <- dbGetQuery(con, query_str, params = list(IdA))
      dbDisconnect(con)
      query_result
    }, error = function(e) {
      # 返回错误详情方便排查
      list(error_message = e$message)
    })
  }
  

• 验证参数传递方式：如果是GET请求，URL要写成http://你的API地址/fetch-data?IdA=1365350；如果是POST请求，要确认请求体里的参数名是IdA，格式是JSON或表单数据。

关键提醒 #

• 绝对不能直接把用户输入拼进SQL语句里，既容易出错，还会有SQL注入风险。
• 硬编码能成功说明数据库连接没问题，问题肯定出在参数传递或类型转换环节。
• 检查SQL语句里的表名、字段名是否和数据库里的一致，别因为字段写错导致查询失败。

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