Opencart 3.8：文件夹/文件名含空格致图片无法显示，求代码修改方案

核心问题分析 #

本地服务器自动将空格转义为%20并支持特殊字符解析，但生产服务器未做对应处理；直接用str_replace(' ', '%20', $image_new)仅处理了空格，且未覆盖所有路径处理环节，同时忽略了像ã这类非ASCII特殊字符的编码需求，导致图片仍无法加载。

解决方案 #

方案1：修改图片URL生成逻辑（推荐） #

找到Opencart负责生成图片URL的核心文件catalog/model/tool/image.php，修改其中生成图片URL的代码，使用rawurlencode()对路径的每个分段进行编码，确保空格和特殊字符都被正确转义：

// 替换原图片URL生成代码
$path_segments = explode('/', $image);
$encoded_segments = array_map('rawurlencode', $path_segments);
$encoded_image = implode('/', $encoded_segments);
$image_new = $this->config->get('config_url') . 'image/' . $encoded_image;

这个方法会自动处理：

• 空格转为%20
• 特殊字符（如ã）转为对应的URL编码（%C3%A3）
• 覆盖所有通过该模型生成的图片URL，包括前台商品图、后台文件管理器预览图等

方案2：修改服务器配置（可选，需服务器权限） #

如果无法修改Opencart代码，可通过服务器配置自动转义空格：

• Apache：在网站根目录的.htaccess中添加规则

RewriteEngine On
RewriteRule ^image/(.*)\ (.*)$ image/$1%20$2 [N,R=301]

• Nginx：在站点配置文件中添加

location /image/ {
    rewrite ^(.*)\ (.*)$ $1%20$2 permanent;
}

注意：该方法仅处理空格，无法解决特殊字符的编码问题，且大量文件可能导致跳转性能损耗。

方案3：检查SEO URL设置 #

进入Opencart后台System > Settings > 编辑对应店铺 > Server，确保Use SEO URLs的配置与服务器环境匹配；同时检查根目录.htaccess文件中的默认重写规则是否完整，避免规则过滤掉带空格的路径。

验证 #

修改完成后，查看页面源码中的图片URL，示例路径catalog/dia da mãe/Borboleta 1.jpg应被转为catalog/dia%20da%20m%C3%A3e/Borboleta%201.jpg，此时服务器即可正确解析并加载图片。

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