解决 PHP mysql_fetch_array: expects parameter 1 to be resource, array given

错误现象与本质

当你在 PHP 脚本中执行数据库操作时，如果控制台或网页输出类似如下的警告：

这说明 mysql_fetch_array() 函数期望第一个参数是一个结果集资源 (resource)，但你实际上传递了一个数组 (array) 或者在某些上下文中被误判为其他非资源类型。

需要特别指出的是，原生 mysql_* 系列函数在 PHP 5.5 中已废弃，并在 PHP 7.0 中被完全移除。如果你正在使用较新版本的 PHP 环境看到此错误，极可能是因为代码混淆了不同扩展的返回值，或者你引用的文档已过时。但在遗留系统维护中，理解这一错误的机制依然重要。

常见触发场景分析

第1步：检查变量是否被意外覆盖或传递错误

最常见的情况是在编写封装类或辅助函数时，传参顺序错误或变量作用域混乱。

• 典型错误代码结构：

function fetch_array($query) {
    // 错误：这里 $query 可能已经不是一个资源，而是一个之前的查询结果数组或其他类型
    return mysql_fetch_array($query);
}

// 调用处
$result = mysql_query("SELECT * FROM users");
fetch_array($result); 
// 如果之前有逻辑将 $result 赋值为了其他值，或者混淆了变量名，就会出错

第2步：排查 SQL 查询是否成功执行

虽然直接报 “array given” 通常指传参类型不对，但有时开发者会先捕获了错误结果，然后未加判断就继续处理，导致后续步骤逻辑混乱。如果 mysql_query() 执行失败，它返回 false (布尔值)，而不是资源。虽然报错信息说 “array”，但如果你的自定义封装函数内部逻辑有误，也可能间接导致此类歧义。

正确做法：永远先判断查询是否成功。

$result = mysql_query($sql);
if (!$result) {
    die('Query Failed: ' . mysql_error());
}
while ($row = mysql_fetch_array($result)) {
    // 处理数据
}

第3步：检查是否存在命名空间或函数冲突

如果你的项目中同时引入了多个数据库抽象层（例如 PDO、MySQLi 和旧的 mysql 扩展），并且定义了同名的函数，可能会导致调用到错误的函数版本，从而产生类型不匹配错误。

修复方案与最佳实践

第4步：重构为 mysqli 或 PDO（强烈推荐）

由于原生 mysql 扩展已不可用，最彻底的解决方案是升级代码。以下是使用 mysqli 的标准写法对照：

旧式写法（易错且不安全）：

$conn = mysql_connect("host", "user", "pass");
mysql_select_db("database");
$query = mysql_query("SELECT * FROM table");
$row = mysql_fetch_array($query); // 风险点

新版 mysqli 写法（安全且规范）：

$conn = new mysqli("host", "user", "pass", "database");
$result = $conn->query("SELECT * FROM table");
if ($result) {
    while ($row = $result->fetch_array()) {
        echo $row['column_name'];
    }
    $result->close();
} else {
    echo "Error: " . $conn->error;
}

第5步：如果是遗留系统的临时应急修复

如果你暂时无法重构代码，必须确认传给 mysql_fetch_array 的变量确实是资源类型。你可以在调用前进行严格检查：

function safe_fetch($res) {
    if (!is_resource($res)) {
        // 记录日志或抛出明确异常，而不是让程序静默失败或报类型错误
        error_log("Invalid resource passed to fetch function");
        return false;
    }
    return mysql_fetch_array($res);
}

总结

“expects parameter 1 to be resource, array given” 错误的核心在于数据类型不匹配。在 PHP 数据库编程中，务必区分“查询资源”、“结果数组”和“布尔状态”。对于现代开发，请彻底放弃 mysql_* 函数，转向 mysqli 或 PDO，它们提供了更清晰的 API 和更好的安全性支持。

以上就是 PHP 解决 mysql_fetch_array 资源类型报错的详细内容，更多关于 PHP 数据库优化及 mysqli 用法资料请关注本站其它相关文章！