WooCommerce结账页支付网关图片不显示，修改PHP URL后仍无效求助

数据老陈

2026-8-19

解决WooCommerce结账页面支付网关图片不显示问题

问题背景

尝试修改WooCommerce结账页面支付网关选项的图标，已更新PHP文件内的图片URL，但图片始终无法正常显示。

排查修复方案

验证图片可访问性：把PHP里的图片URL直接复制到浏览器地址栏打开，确认能加载。如果打不开：
- 核对图片路径是否正确，避免拼写错误、目录层级错误
- 检查服务器上图片文件是否存在，位置与URL对应
- 调整图片文件权限为644，所在目录权限设为755

改用WordPress路径函数：不要硬编码URL，用内置函数确保路径正确，示例代码：

// 第55行修改示例
$gateway->icon = esc_url( wp_upload_dir()['baseurl'] . '/uploads/2024/05/your-payment-icon.png' );
// 或者主题目录下的图片
$gateway->icon = esc_url( get_stylesheet_directory_uri() . '/assets/images/payment-icon.png' );

清除所有缓存：清空WordPress缓存插件、浏览器缓存，若用了CDN也要刷新CDN缓存，避免加载旧资源

检查钩子与代码逻辑：如果是通过钩子修改图标，确认钩子优先级和网关ID匹配，示例：

add_filter( 'woocommerce_gateway_icon', 'customize_payment_icon', 10, 2 );
function customize_payment_icon( $icon, $gateway_id ) {
    if ( $gateway_id == 'your_gateway_slug' ) {
        $icon = '<img src="' . esc_url( get_site_url() . '/wp-content/uploads/custom-icon.png' ) . '" alt="Custom Payment Icon">';
    }
    return $icon;
}