怎样使用 mysqli_stmt::$error_list 来获取和管理多条错误信息？

gitbox 2025-08-24

在使用 MySQLi 扩展进行数据库操作时，错误处理是开发过程中一个重要的环节。通常，我们会使用 mysqli_error() 或 mysqli_stmt_error() 来获取单一的错误信息。然而，MySQLi 提供了 mysqli_stmt::$error_list 属性，它允许我们在执行准备语句时捕获和管理多个错误信息。这对于复杂的 SQL 操作尤为重要，能够帮助我们更好地调试和优化代码。

1. mysqli_stmt::$error_list 的概述

mysqli_stmt::$error_list 是一个类数组（array），存储了与当前语句对象相关的所有错误信息。通过它，我们可以获取详细的错误信息列表，而不仅仅是单一的错误。它会返回一个数组，其中每个元素代表一次错误的具体描述，包括错误代码和错误文本。

2. 使用 mysqli_stmt::$error_list

要使用 mysqli_stmt::$error_list，我们首先需要创建一个 MySQLi 连接，然后准备并执行一个 SQL 语句。如果执行过程中出现了多个错误，$error_list 将包含所有的错误信息。接下来，我们通过访问 error_list 属性来查看错误详情。

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 创建 MySQLi 连接</span></span><span>
</span><span><span class="hljs-variable">$mysqli</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title function_ invoke__">mysqli</span></span><span>(</span><span><span class="hljs-string">"localhost"</span></span><span>, </span><span><span class="hljs-string">"username"</span></span><span>, </span><span><span class="hljs-string">"password"</span></span><span>, </span><span><span class="hljs-string">"database"</span></span><span>);

</span><span><span class="hljs-comment">// 检查连接是否成功</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"连接失败: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error);
}

</span><span><span class="hljs-comment">// 准备 SQL 语句</span></span><span>
</span><span><span class="hljs-variable">$stmt</span></span><span> = </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">prepare</span></span><span>(</span><span><span class="hljs-string">"INSERT INTO users (username, email) VALUES (?, ?)"</span></span><span>);

</span><span><span class="hljs-comment">// 检查 SQL 语句是否准备成功</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$stmt</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"SQL 错误: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;error);
}

</span><span><span class="hljs-comment">// 绑定参数</span></span><span>
</span><span><span class="hljs-variable">$username</span></span><span> = </span><span><span class="hljs-string">"testuser"</span></span><span>;
</span><span><span class="hljs-variable">$email</span></span><span> = </span><span><span class="hljs-string">"invalidemail.com"</span></span><span>; </span><span><span class="hljs-comment">// 假设这里的邮箱格式是无效的</span></span><span>
</span><span><span class="hljs-variable">$stmt</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">bind_param</span></span><span>(</span><span><span class="hljs-string">"ss"</span></span><span>, </span><span><span class="hljs-variable">$username</span></span><span>, </span><span><span class="hljs-variable">$email</span></span><span>);

</span><span><span class="hljs-comment">// 执行 SQL 语句</span></span><span>
</span><span><span class="hljs-variable">$stmt</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">execute</span></span><span>();

</span><span><span class="hljs-comment">// 如果有错误，输出错误列表</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$stmt</span></span><span>-&gt;errno) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"执行错误: "</span></span><span> . </span><span><span class="hljs-variable">$stmt</span></span><span>-&gt;error . </span><span><span class="hljs-string">"\n"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"错误详情：\n"</span></span><span>;
    
    </span><span><span class="hljs-comment">// 打印所有错误信息</span></span><span>
    </span><span><span class="hljs-title function_ invoke__">print_r</span></span><span>(</span><span><span class="hljs-variable">$stmt</span></span><span>-&gt;error_list);
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"插入成功!"</span></span><span>;
}

</span><span><span class="hljs-comment">// 关闭语句和连接</span></span><span>
</span><span><span class="hljs-variable">$stmt</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">close</span></span><span>();
</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">close</span></span><span>();
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在这个例子中，我们首先尝试向 users 表中插入一条数据。由于 email 字段的值 invalidemail.com 格式不正确，MySQL 会返回多个错误信息，这些信息会被保存在 error_list 中。

3. 处理 error_list 中的多个错误

mysqli_stmt::$error_list 返回的数组包含了错误的各个部分，通常每个元素是一个包含两个字段的关联数组：errno 和 error。errno 表示错误代码，error 则是错误信息的描述。我们可以通过循环遍历这个数组，逐一输出每个错误的详细信息。

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 检查是否有多个错误</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">count</span></span><span>(</span><span><span class="hljs-variable">$stmt</span></span><span>-&gt;error_list) &gt; </span><span><span class="hljs-number">0</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"存在多个错误:\n"</span></span><span>;
    </span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$stmt</span></span><span>-&gt;error_list </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$error</span></span><span>) {
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"错误代码: "</span></span><span> . </span><span><span class="hljs-variable">$error</span></span><span>[</span><span><span class="hljs-string">'errno'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"错误信息: "</span></span><span> . </span><span><span class="hljs-variable">$error</span></span><span>[</span><span><span class="hljs-string">'error'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
    }
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

这个示例会将每个错误代码和相应的错误信息逐一输出。如果存在多个错误，我们可以更加清晰地了解发生了哪些问题，并且针对不同的错误进行适当的处理。

4. mysqli_stmt::$error_list 的优势

使用 mysqli_stmt::$error_list 的一个重要优势是它能够捕获多条错误信息。在一些复杂的数据库操作中，可能由于多个原因导致错误，而 error_list 能够帮助开发者一次性获取所有错误，从而提高调试效率。而且，通过这种方式，我们可以更精细地控制错误处理逻辑，比如根据不同的错误类型执行不同的操作。

5. 小结

mysqli_stmt::$error_list 是 MySQLi 提供的一个强大功能，它使得开发者可以在执行 SQL 语句时捕获和处理多条错误信息。通过使用这个属性，我们能够更好地理解 SQL 执行过程中的问题，从而提升数据库操作的稳定性和代码的可靠性。

相关标签:
mysqli_stmt

mysqli_stmt::$error_list