该警告是运行时类型错误，因foreach接收了非数组类型（如null、false、string等）；应先用var_dump或gettype定位实际类型，再通过is_array判断或(array)强转确保输入为有效数组。
foreach 报 Warning: Invalid argument supplied for foreach() 怎么快速定位
这个警告不是语法错误，而是运行时类型错误：你传给 foreach 的变量根本就不是数组——可能是 null、false、string、int，甚至未定义的变量（undefined variable）。最常见于数据库查询失败、API 返回空/错误响应、配置项缺失或缓存失效后未兜底。
别急着加判断，先确认源头：
- 用
var_dump($data)或gettype($data)看它到底是什么类型，而不是只看empty($data) - 检查上游赋值语句，比如
$items = $db->query(...)是否可能返回false（PDO 默认不抛异常） - 注意模板层变量传递是否漏了，例如 ThinkPHP 的
assign('list', $list)中$list根本没声明
两种稳妥的修复方式：判断 or 强转
修复的核心是让 foreach 永远收到一个「有效数组」。空数组 [] 是完全合法的，不会触发警告；而 null 或 false 不行。
推荐优先使用显式判断：
立即学习“PHP免费学习笔记（深入）”；
if (is_array($items) && !empty($items)) {
foreach ($items as $item) {
// ...
}
}
更简洁且安全的写法（兼顾未定义变量）：
foreach ((array) $items as $item) {
// 即使 $items 是 null / false / string / object，(array) 都会转成数组
// null → [], false → [], 'abc' → [0 => 'abc'], new StdClass → []
}
注意：(array) 强转对对象会丢失方法和私有属性，仅保留 public 属性；若需保留结构，应改用 json_decode(json_encode($obj), true) 或提前规范数据契约。
为什么不能只用 empty() 或 count() 判断
empty($items) 和 count($items) > 0 都会触发 PHP 的「隐式类型转换」，在变量为 null、false、0、'' 时返回 true，但它们本身不是数组，foreach 仍会报错。
例如：
-
$items = 0;→empty($items) === true，但foreach($items as ...)直接报错 -
$items = '';→count($items) === 0，但foreach依然拒绝执行 -
$items = [];→ 安全，is_array($items) === true，count($items) === 0，foreach正常跳过
所以必须先过 is_array() 这关，再谈内容是否为空。
模板引擎里怎么防（以 Smarty / Blade / ZBP 为例）
很多模板报这个错，是因为 PHP 层没做兜底，把非数组直接塞进了模板变量。不同引擎处理方式不同：
- Smarty：用
{if is_array($list)}{foreach from=$list item=i}{/if}，或在 assign 前统一转(array)$list - Blade：
@foreach($items as $item)会直接报错，应在 controller 中确保$items是数组，或用$items ?? [] - ZBP 主题：常见于热搜词、导航菜单等动态数据，出错时间点不稳定（如你说的“下班后才报”），大概率是缓存失效 + 查询失败未 fallback，修复点在 PHP 层的
GetList类方法里补return (array)$result;
模板层永远不该承担类型校验责任；所有外部输入（DB、API、$_GET）都应在进入模板前完成清洗和默认值设定。
