WordPress多站点特色图片重命名异常问题求助

可能的触发原因 #

• 文件上传并发冲突：多站点环境下，若两个操作（或同一用户快速上传）同时提交同名图片，WordPress默认会自动添加-1后缀重命名，而LiteSpeed服务器的异步上传处理可能导致文件名校验的时序偏差，偶发跨文章的关联异常。
• LiteSpeed缓存临时文件干扰：缓存插件处理媒体文件缓存时，若临时文件清理不及时，可能出现文件名映射错误，这类问题通常单次触发，后续缓存刷新后就恢复正常。
• 多站点媒体库权限/共享异常：如果站点开启了媒体库跨站点共享，文件名冲突时可能出现错误关联，但你后续上传正常，说明大概率是偶发的时序问题。

规避措施 #

• 强制自定义图片命名规则：在主题functions.php或自定义插件中添加代码，给上传图片自动加上站点ID前缀，从根源避免同名冲突：

  add_filter('sanitize_file_name', 'custom_media_file_name', 10, 2);
  function custom_media_file_name($filename, $filename_raw) {
      global $blog_id;
      $info = pathinfo($filename);
      $new_filename = 'site-' . $blog_id . '-' . $info['filename'] . '.' . $info['extension'];
      return $new_filename;
  }
  

• 调整LiteSpeed缓存媒体设置：进入LiteSpeed缓存插件的「媒体」设置项，开启「媒体文件缓存独立化」，同时打开「自动清理过期临时文件」，避免缓存文件混淆。
• 限制上传并发数：在LiteSpeed服务器控制台中，将WordPress站点的「文件上传并发连接数」调整为1-2，减少同时上传时的文件名校验冲突概率。
• 强化WP文件名唯一性校验：在wp-config.php中添加define('MEDIA_TRASH', true);，启用媒体回收站的同时，确保新版WordPress自带的文件名唯一性校验逻辑正常运行。

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