OpenCart 3迁移至Hostinger后产品图片丢失求助（特殊字符目录问题）

问题根源 #

Hostinger服务器环境对土耳其语特殊字符（Ö、Ü、Ğ、Ç、İ/ı）及空格的文件路径解析不兼容，导致图片返回404错误，需批量同步修改数据库路径与服务器文件/目录名。

一、通过phpMyAdmin批量修改数据库图片路径 #

1. 登录Hostinger控制面板，打开phpMyAdmin，选择你的OpenCart数据库（注意表前缀，默认是oc_，需替换为实际前缀）。
2. 执行以下SQL语句，批量替换所有相关表中的特殊字符与空格：

   -- 替换产品表图片路径
   UPDATE oc_product 
   SET image = REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(image, 'Ö', 'O'), 'Ü', 'U'), 'Ğ', 'G'), 'Ç', 'C'), 'İ', 'I'), ' ', '_');
   
   -- 替换产品图片表路径
   UPDATE oc_product_image 
   SET image = REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(image, 'Ö', 'O'), 'Ü', 'U'), 'Ğ', 'G'), 'Ç', 'C'), 'İ', 'I'), ' ', '_');
   
   -- 若分类图片也有问题，执行此语句
   UPDATE oc_category 
   SET image = REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(image, 'Ö', 'O'), 'Ü', 'U'), 'Ğ', 'G'), 'Ç', 'C'), 'İ', 'I'), ' ', '_');
   

3. 执行完成后，刷新数据库，确认路径已完成替换。

二、批量重命名服务器上的图片目录/文件 #

方法1：PHP脚本批量处理（适合无SSH权限用户） #

1. 在Hostinger文件管理器中，进入public_html目录，新建rename_images.php文件，写入以下内容：

   <?php
   $targetDir = 'image/catalog/'; // OpenCart产品图片存储目录
   $charMap = [
       'Ö' => 'O', 'Ü' => 'U', 'Ğ' => 'G', 'Ç' => 'C',
       'İ' => 'I', 'ı' => 'i', ' ' => '_'
   ];
   
   function recursiveRename($dir, $map) {
       $items = scandir($dir);
       foreach ($items as $item) {
           if ($item === '.' || $item === '..') continue;
           $oldPath = rtrim($dir, '/') . '/' . $item;
           $newName = strtr($item, $map);
           $newPath = rtrim($dir, '/') . '/' . $newName;
   
           if (is_dir($oldPath)) {
               rename($oldPath, $newPath);
               recursiveRename($newPath, $map); // 递归处理子目录
           } else {
               rename($oldPath, $newPath);
           }
       }
   }
   
   recursiveRename($targetDir, $charMap);
   echo "批量重命名完成，请立即删除此文件！";
   ?>
   

2. 访问你的域名+/rename_images.php（如https://innturk.com/rename_images.php），执行脚本。
3. 执行完成后，立即删除rename_images.php文件（避免安全风险）。

方法2：SSH命令批量处理（效率更高） #

1. 登录Hostinger SSH终端，进入OpenCart图片目录：

   cd public_html/image/catalog/
   

2. 执行递归重命名命令：

   find . -depth -exec rename 's/Ö/O/g; s/Ü/U/g; s/Ğ/G/g; s/Ç/C/g; s/İ/I/g; s/ı/i/g; s/ /_/g' {} \;
   

三、验证与收尾 #

1. 访问示例产品页面，检查图片是否正常加载。
2. 随机抽检多个产品、分类页面，确认图片无404问题。
3. 进入OpenCart后台，依次点击系统→设置→编辑当前商店→服务器→清除缓存，刷新前端页面确保缓存更新。

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