Woocommerce中class-wc-admin-dashboard.php抛出PHP警告如何处理

开发者阿泽

2026-9-26

问题原因

警告的直接触发逻辑是/public_html/wp-content/plugins/woocommerce/includes/admin/class-wc-admin-dashboard.php第543行的foreach()语句接收到的参数不是数组或可遍历对象，对应WooCommerce后台仪表盘的统计数据拉取逻辑
常见诱因分为三类：
1. WooCommerce版本过旧，旧版本该位置没有做非数组兼容校验，当站点缓存异常、用户权限不足访问统计接口、或者统计数据为空时，就会触发警告
2. 第三方WooCommerce扩展/自定义主题修改了仪表盘统计项的返回值，本该返回数组的逻辑返回了null、布尔值等非可遍历类型
3. referer字段不固定是因为该错误由后台AJAX接口触发，不管是前台页面（比如管理员登录状态下顶部工具栏显示商城统计、主题自定义的前台统计模块）还是后台页面，只要发起了对应统计接口的请求都会触发警告，所以来源页面不固定

解决方法

优先升级WooCommerce到最新正式版，高版本官方已经修复了该位置的参数校验问题，新增了is_array()判断后才执行遍历，升级后可直接消除警告

如果暂时无法升级WooCommerce，可手动修改对应文件做临时兼容：
找到第543行的foreach代码，在外部新增可遍历性判断，示例如下：

// 原代码结构
foreach ( $stat_items as $item ) {
    // 原有业务逻辑
}

// 修改后结构
if ( is_array( $stat_items ) || $stat_items instanceof \Traversable ) {
    foreach ( $stat_items as $item ) {
        // 原有业务逻辑保持不变
    }
}

修改插件核心文件前请先备份原文件，避免语法错误导致站点异常

排查扩展/主题冲突：停用所有非官方WooCommerce扩展，切换到WordPress默认主题，逐个启用排查是哪个扩展/主题修改了统计返回值，找到后联系对应开发者修复逻辑，避免后续WooCommerce升级后问题复现
如果不需要使用WooCommerce仪表盘统计功能，可直接在站点根目录wp-config.php中添加代码禁用对应功能：
add_filter( 'woocommerce_enable_admin_dashboard_widgets', '__return_false' );