php mysqli_query函数执行失败怎么办？教你快速找到错误原因。

发布日期： 2025-10-09 阅读量： 作者： admin

今天下午没事，就想着把之前搞了一半的PHP项目再捡起来弄弄。主要是想把数据存到数据库里去，自然就用到了MySQLi这套东西。

连接数据库

肯定得先连上数据库。这个之前弄过，用的是 `mysqli_connect`。主机名、用户名、密码、数据库名，这几个参数填对，一般问题不大。试了一下，连接本身是成功的，拿到了一个连接对象，先放一边，后面要用。

接下来就是正题了，执行SQL查询。我想先试试最简单的，往一个测试表里插条数据。表结构很简单，就一个自增ID和一个名字字段。

我就写了个SQL语句，类似 `INSERT INTO test_table (name) VALUES ('张三')` 这样。然后就直接调用 `mysqli_query` 函数，把之前的数据库连接对象和这个SQL语句传进去。

代码大概是这样：

$sql = "INSERT INTO test_table (name) VALUES ('张三')";
$result = mysqli_query($link, $sql); // $link 是我连接数据库拿到的那个东西

执行完，我寻思着应该成了。但为了保险起见，我打印了一下 `$result` 变量。结果不是我想的那样，它返回了个 `false`！这就说明查询失败了。

当时有点懵，心想这 SQL 看着也没错，表名、字段名都对得上。连接也是好的。咋回事？

这时候我想起来，`mysqli_query` 如果执行失败返回 `false`，那肯定有具体的错误信息。我赶紧查了下，对了，可以用 `mysqli_error()` 函数，它需要把数据库连接对象传进去。

我就在原来的代码后面加了一句：

if ($result === false) {
echo "查询失败了，错误信息：" . mysqli_error($link);

然后重新跑了一下。 这下好了，错误信息出来了！屏幕上打印出类似 "Table 'your_database_*_table' doesn't exist" 的提示。

我这才恍然大悟！原来是我犯了个低级错误，我以为我创建了 `test_table` 这张表，实际上我在数据库里创建的名字是 `my_test_table`！写代码的时候想

找到问题就好办了。我赶紧把SQL语句里的表名改正确：

$sql = "INSERT INTO my_test_table (name) VALUES ('李四')"; // 改了表名，顺便换个名字试试
$result = mysqli_query($link, $sql);

这回再执行。 没报错！我再打印了一下 `$result`，这回它返回的是 `true`。为了确认，我还去数据库后台看了下，果然，`my_test_table` 表里成功插入了一条名字叫“李四”的记录。

搞定了之后，感觉也没那么难，但过程还是挺折腾的。主要就是：

细心检查SQL语句： 表名、字段名、语法，一点都不能错。我这回就是栽在表名上了。
必须做错误处理： `mysqli_query` 执行完，一定要判断下结果是不是 `false`。如果是，立刻用 `mysqli_error()` 把错误原因打出来，不然两眼一抹黑，根本不知道哪里出了问题。

`mysqli_query` 本身用起来不复杂，关键是配套的错误检查得跟上。今天这个实践算是又加深了一遍印象，以后写代码可得注意这些细节。