如何修复Magento2站点地图模块的Uncaught TypeError错误？

问题核心原因 #

报错Uncaught TypeError: htmlspecialchars() expects parameter 1 to be string, null given来自两个关键问题：

1. 变量引用错误：循环遍历的是单个图片对象$image，但代码中调用$images->getTitle()和$images->getThumbnail()时，误用了外层的集合对象$images而非当前循环的单个图片实例，导致返回null值。
2. 未处理空值场景：即使调用正确的对象方法，图片的title、thumbnail等字段也可能为空，直接传入htmlspecialchars()会触发类型错误。

修复代码 #

修改/var/www/html/app/code/SEO/XmlSitemap/Model/Writer.php中的getImageXml方法，修正变量引用并处理空值：

protected function getImageXml(DataObject $images): string
{
    $xml = '';
    foreach ($images->getCollection() as $image) {

        $this->imageCount++;
        // 强制转换为字符串，避免null传入htmlspecialchars
        $preparedImageUrl     = htmlspecialchars((string)$image->getUrl());
        // 修正变量引用：使用$image而非$images获取thumbnail，同时处理空值
        $preparedThumbnailUrl = htmlspecialchars((string)$image->getThumbnail());
        // 修正变量引用：使用$image而非$images获取title，同时处理空值
        $preparedTitle        = htmlspecialchars((string)$image->getTitle());
        $preparedCaption      = $image->getCaption() ? htmlspecialchars((string)$image->getCaption()) : '';

        $xmlImage = $this->getWrappedString($preparedImageUrl, 'image:loc');
        // 可选：仅当title不为空时生成对应节点，减少无效空节点
        if ($preparedTitle) {
            $xmlImage .= $this->getWrappedString($preparedTitle, 'image:title');
        }
        if ($preparedCaption) {
            $xmlImage .= $this->getWrappedString($preparedCaption, 'image:caption');
        }

        $xml .= $this->getWrappedString($xmlImage, 'image:image');
    }
    
    return $xml;
}

修复说明 #

• 修正变量引用：将$images->getTitle()、$images->getThumbnail()改为$image->getTitle()、$image->getThumbnail()，确保获取当前循环中单个图片的属性值。
• 空值处理：通过(string)强制类型转换，将null值转为空字符串，避免触发htmlspecialchars()的类型错误。
• 优化节点生成：添加非空判断，仅当title不为空时才生成image:title节点，优化sitemap的内容结构。

内容的提问来源于stack exchange，提问作者user86226