KnexJS Raw查询执行异常：含用户变量的SQL解析失败

我之前也碰到过类似的坑，Knex对多语句查询和MySQL会话变量的处理确实有一些容易忽略的细节，下面给你几个可行的解决思路和改写方案：

一、直接修复Raw查询的报错问题 #

你的原语句是两条独立的SQL（初始化变量+更新操作），Knex默认禁止执行多语句查询，这就是触发ER_PARSE_ERROR的核心原因。只需要在创建Knex连接时开启多语句支持即可：

1. 配置Knex连接时启用多语句 #

const knex = require('knex')({
  client: 'mysql',
  connection: {
    host: '你的数据库地址',
    user: '用户名',
    password: '密码',
    database: '数据库名',
    multipleStatements: true // 关键：开启多语句执行权限
  }
});

2. 安全执行Raw查询 #

开启配置后就能正常执行原语句了，但要注意防范SQL注入——如果name是动态传入的值，一定要用参数绑定，不要直接拼接字符串：

const targetName = 'name'; // 可以是前端传入的动态变量
knex.raw(
  `SET @count = 0; UPDATE \`table\` SET id = @count:= @count + 1 WHERE name = ?;`,
  [targetName]
)
.then(() => console.log('更新完成'))
.catch(err => console.error('更新失败:', err));

注意：开启multipleStatements会增加SQL注入风险，务必确保所有动态参数都通过绑定传入，绝对不要直接拼接用户输入的内容。

二、用Knex原生方法改写（推荐MySQL 8.0+） #

如果你的MySQL版本是8.0及以上，推荐用窗口函数替代会话变量，这种写法更贴合Knex的使用习惯，也不需要额外配置多语句：

knex('table')
  .update({
    id: knex.raw('ROW_NUMBER() OVER (ORDER BY (SELECT NULL))')
  })
  .where('name', 'name')

• ORDER BY (SELECT NULL)表示不指定排序顺序，如果需要按特定字段（比如创建时间）排序，可以改成ORDER BY created_at；
• 这种写法无需额外配置，安全性更高，也更符合ORM的设计思路。

三、旧版本MySQL的替代方案（低于8.0） #

如果你的MySQL版本不支持窗口函数，除了第一种多语句方法，还可以把变量初始化和更新合并成单条语句，避免开启多语句配置：

const targetName = 'name';
knex.raw(
  `UPDATE \`table\` SET id = @count:= @count + 1 
   WHERE name = ? 
   AND (SELECT @count := 0) IS NOT NULL`,
  [targetName]
)

通过子查询在执行UPDATE前完成变量初始化，同样能实现自增ID的效果，且不需要修改Knex的连接配置。

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