为何MySQL语句在mysqli_connect报错，CLI与phpMyAdmin却可正常执行？

问题场景 #

以MySQL 8.0为例，使用PHP的mysqli_connect执行包含多条SQL语句的代码时返回语法错误，但完全相同的语句在MySQL命令行（CLI）和phpMyAdmin中能成功执行：

执行代码 #

// 创建连接
$conn = mysqli_connect($servername, $username, $password, $dbname);
// 检查连接
if (!$conn) {
  die("连接失败: " . mysqli_connect_error());
}

$sql = "USE aTable; INSERT INTO aTable (`aColumn`) VALUES ('aValue');";

if (mysqli_query($conn, $sql)) {
  echo "新记录创建成功";
} else {
  echo "错误: " . $sql . "<br>" . mysqli_error($conn);
}

mysqli_close($conn);
?>

PHP执行错误输出 #

USE aTable; INSERT INTO aTable (aColumn) VALUES ('aValue');

Error: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'INSERT INTO aTable (aColumn) VALUES ('aValue')' at line 1

phpMyAdmin执行结果 #

1 row inserted.

Inserted row id: 6 (Query took 0.0063 seconds.)

USE aTable; INSERT INTO aTable (aColumn) VALUES ('aValue');

原因分析 #

核心原因是PHP的mysqli_query()函数默认不支持执行多条用分号分隔的SQL语句，而MySQL CLI、phpMyAdmin这类客户端会自动处理多语句拆分：

• mysqli_query()会把整个字符串当作单条SQL语句解析，包含分号的多语句会被判定为语法错误。
• MySQL CLI和phpMyAdmin的底层逻辑会以分号为分隔符，自动把多语句拆分成独立的单条语句，再逐一发送给MySQL服务端执行，因此不会报错。

另外补充：代码中连接数据库时已经指定了$dbname参数，USE aTable语句其实是多余的，完全可以省略。

解决办法 #

方法1：拆分语句单独执行（推荐） #

把多条SQL语句拆分成独立的字符串，分别调用mysqli_query()执行：

$conn = mysqli_connect($servername, $username, $password, $dbname);
if (!$conn) {
  die("连接失败: " . mysqli_connect_error());
}

// 由于连接时已指定数据库，USE语句可省略
$insertSql = "INSERT INTO aTable (`aColumn`) VALUES ('aValue');";
if (mysqli_query($conn, $insertSql)) {
  echo "新记录创建成功";
} else {
  echo "错误: " . mysqli_error($conn);
}

mysqli_close($conn);
?>

方法2：使用多语句执行函数（需注意安全风险） #

如果必须执行多语句，可以使用mysqli_multi_query()函数，但这种方式存在较高的SQL注入风险，务必确保所有输入都经过严格过滤：

$conn = mysqli_connect($servername, $username, $password, $dbname);
if (!$conn) {
  die("连接失败: " . mysqli_connect_error());
}

$sql = "USE aTable; INSERT INTO aTable (`aColumn`) VALUES ('aValue');";
if (mysqli_multi_query($conn, $sql)) {
  echo "新记录创建成功";
} else {
  echo "错误: " . mysqli_error($conn);
}

mysqli_close($conn);
?>

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