MySQL 5.7更新查询仅终端可用，程序中报错原因排查

针对语句 SET @counter=0;UPDATE item SET sequence=(@counter:=@counter+1) WHERE page=1 AND menu_card_id=1 ORDER BY position,id 在终端正常执行但程序频繁报错的情况，常见原因及排查方向如下：

• 多语句执行未开启
  多数程序的数据库客户端为防SQL注入，默认禁用多语句执行。终端支持一次性执行多条分号分隔的语句，但程序里如果没开启对应配置，会把整段语句当作单条SQL解析，直接触发语法错误。解决：开启客户端多语句支持，比如Java JDBC设置allowMultiQueries=true，Python MySQLdb执行时传入multi=True参数。

• 会话变量未在同一会话初始化
  @counter是MySQL会话级变量，仅在当前数据库连接会话内有效。如果程序中SET @counter=0和UPDATE语句分别使用不同的数据库连接（比如连接池未复用、每次执行都新建连接），执行UPDATE时@counter未被初始化，会导致变量不存在的报错。解决：确保两条语句在同一个数据库连接会话中执行。

• ORM/框架的语法解析冲突
  若使用ORM框架（如MyBatis、Hibernate），框架可能把@符号当作参数占位符解析，破坏用户变量的语法结构；或者自动对语句做转义处理（比如转义分号），导致语句拆分失败。解决：针对框架做适配，比如MyBatis中用@@counter转义用户变量，或关闭框架对特定符号的解析逻辑。

• 事务与锁冲突
  终端执行时默认自动提交，而程序中可能将语句放在事务内执行，或其他业务操作持有了item表的行锁/表锁，导致UPDATE语句因锁等待超时或死锁报错。解决：检查程序事务配置，查看数据库锁等待日志（如INFORMATION_SCHEMA.INNODB_LOCKS）排查冲突来源。

• 数据库驱动版本兼容问题
  部分旧版本的数据库驱动对@counter:=@counter+1这种赋值表达式的解析存在bug，导致执行失败。解决：升级数据库驱动到官方最新稳定版本。

• 数据库账号权限差异
  终端使用的数据库账号与程序账号权限不一致，比如程序账号无UPDATE权限，或无使用用户变量的权限（虽少见，但需排除）。解决：对比终端和程序的数据库账号权限，确保程序账号具备所需操作权限。

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