集成Bootstrap5.2到WordPress时使用WP_Bootstrap_Navwalker报错

问题根源 #

报错的核心原因是你给wp_nav_menu()的walker参数传了类名字符串，但WordPress要求这个参数必须是WP_Bootstrap_Navwalker类的实例对象，而非字符串。当代码尝试在字符串上调用walk()方法时，自然会抛出错误。

修正步骤 #

1. 确认functions.php中的引入与注册代码
   确保你已经正确引入navwalker文件并注册了导航菜单，代码示例：

   // 引入wp-bootstrap-navwalker类文件（路径根据实际存放位置调整）
   require_once get_template_directory() . '/class-wp-bootstrap-navwalker.php';
   
   // 注册主导航菜单
   register_nav_menus( array(
       'primary' => esc_html__( 'Primary Menu', 'your-theme-slug' ),
   ) );
   

2. 修正前端wp_nav_menu的调用代码
   将walker参数从类名字符串改为类的实例化对象：

   wp_nav_menu( array(
       'theme_location'  => 'primary',
       'depth'           => 2, // 适配Bootstrap下拉菜单的层级
       'container'       => 'div',
       'container_class' => 'collapse navbar-collapse',
       'container_id'    => 'navbarSupportedContent',
       'menu_class'      => 'navbar-nav me-auto mb-2 mb-lg-0',
       'fallback_cb'     => 'WP_Bootstrap_Navwalker::fallback',
       'walker'          => new WP_Bootstrap_Navwalker(), // 关键：实例化类，而非字符串
   ) );
   

额外检查项 #

• 确认class-wp-bootstrap-navwalker.php文件确实放在了你指定的路径下（通常是主题根目录），路径错误会导致类无法被正确加载。
• 确保你使用的wp-bootstrap-navwalker是适配Bootstrap5的版本（v5.x），旧版本的实现逻辑不同，可能引发兼容性问题。
• 检查类名拼写是否完全一致，大小写错误也会导致类无法被实例化。

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