WordPress升级后出现jQuery版本兼容错误致图片消失求助

问题说明 #

控制台报错：

Uncaught Error: Bootstrap's JavaScript requires jQuery version 1.9.1 or higher, but lower than version 3

当前jQuery版本为1.12.x（理论上满足Bootstrap要求），但升级后网站图片全部消失。

解决步骤 #

• 排查Bootstrap加载顺序
  确保jQuery脚本在Bootstrap JS之前加载。可以在主题的functions.php里检查wp_enqueue_script的调用顺序，通过依赖参数强制Bootstrap延后加载：

  wp_enqueue_script( 'jquery' );
  wp_enqueue_script( 'bootstrap-js', get_template_directory_uri() . '/js/bootstrap.min.js', array( 'jquery' ), '3.4.1', true );
  

  其中第三个参数array('jquery')会让WordPress自动保证jQuery先于Bootstrap加载。

• 启用jQuery Migrate
  WordPress 6.x默认移除了jQuery Migrate，旧主题/插件可能依赖它运行。在functions.php中添加代码重新启用：

  add_action( 'wp_enqueue_scripts', function() {
      if ( ! is_admin() ) {
          wp_enqueue_script( 'jquery-migrate' );
      }
  } );
  

• 替换兼容的Bootstrap版本
  如果当前使用的Bootstrap版本存在隐性兼容性问题，替换为支持jQuery 1.9.1-2.x的稳定版（比如Bootstrap 3.4.x或4.6.x），这两个版本都能完美适配1.12.x的jQuery。

• 修复图片显示问题

  • 临时禁用所有第三方插件，逐个重新启用排查冲突源
  • 检查主题自定义JS中是否有依赖旧jQuery语法的图片懒加载、媒体库处理代码，修改为兼容当前版本的写法
  • 登录后台媒体库，确认图片路径是否正常，重新上传一张测试图验证显示逻辑

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