DBeaver批量执行SQL报错排查与allowMultiQueries参数详解

1. 从Navicat到DBeaver：批量执行SQL的痛点解析

很多开发者从Navicat转向DBeaver时，第一个遇到的"拦路虎"就是批量执行SQL语句的问题。我刚开始用DBeaver时也踩过这个坑——明明在Navicat里可以顺畅执行的多条INSERT语句，到了DBeaver却总是报错。比如下面这个典型场景：

sql复制INSERT INTO users VALUES (1, '张三');
INSERT INTO users VALUES (2, '李四');
INSERT INTO users VALUES (3, '王五');

执行后DBeaver会直接报错，提示语法错误。但奇怪的是，单独执行其中任何一条语句都能成功。这其实是因为DBeaver默认的安全策略与Navicat不同，它禁用了批量查询（multi-queries）功能。这种设计差异主要基于两个考虑：

1. 安全防护：批量执行可能带来SQL注入风险
2. 结果集处理：多条语句的执行结果需要特殊处理机制

我在实际项目中遇到过更复杂的情况。有次需要导入包含300多条记录的Excel数据，手动单条执行简直要命。后来发现，只要理解DBeaver的工作原理，这个问题其实很好解决。

2. 问题重现与根因分析

2.1 典型报错场景还原

让我们通过一个完整示例重现问题。首先创建测试表：

sql复制CREATE TABLE employee (
    id INT PRIMARY KEY,
    name VARCHAR(50),
    department VARCHAR(50)
);

然后尝试批量插入数据：

sql复制INSERT INTO employee VALUES (101, '张三', '研发部');
INSERT INTO employee VALUES (102, '李四', '市场部');
INSERT INTO employee VALUES (103, '王五', '人事部');

在DBeaver中执行会得到类似这样的错误：

code复制SQL Error: You have an error in your SQL syntax...

但查看数据库会发现，*没有任何数据被插入