bootstrap 4 导航栏在移动端点击汉堡图标无响应,通常是因 jquery、popper.js 或 bootstrap js 版本不匹配或过时导致,需确保三者版本兼容且按正确顺序加载。
bootstrap 4 导航栏在移动端点击汉堡图标无响应,通常是因 jquery、popper.js 或 bootstrap js 版本不匹配或过时导致,需确保三者版本兼容且按正确顺序加载。
在使用 Bootstrap 4 构建响应式导航栏(Navbar)时,一个常见却容易被忽视的问题是:移动端折叠菜单(collapse navbar)点击后不展开——即“汉堡图标”(navbar-toggler)点击无效,下拉链接始终不可见。这并非 HTML 结构错误,而多源于 JavaScript 依赖项的版本冲突或加载缺失。
根本原因分析
Bootstrap 4 的 data-toggle="collapse" 功能高度依赖三个外部脚本:
- jQuery(必需,用于 DOM 操作与事件绑定)
- Popper.js(必需,用于 tooltip、popover 及部分 dropdown 定位,Bootstrap 4 的 collapse 组件内部也间接依赖其运行环境)
- Bootstrap JS(提供 collapse 插件实现)
你的原始代码中引入了:
<script src="https://code.jquery.com/jquery-3.3.1.slim.min.js">...</script><script src="https://cdn.jsdelivr.net/npm/popper.js@1.14.6/dist/umd/popper.min.js">...</script><script src="https://cdn.jsdelivr.net/npm/bootstrap@4.2.1/dist/js/bootstrap.min.js">...</script>
虽然版本看似接近,但 jQuery 3.3.1 slim + Popper 1.14.6 + Bootstrap 4.2.1 存在已知兼容性问题:
- jquery-3.3.1.slim.min.js 移除了 $.support 等旧 API,而 Bootstrap 4.2.1(尤其是某些 CDN 构建版本)仍存在对这些 API 的隐式调用;
- Popper.js 1.14.6 与较新 Bootstrap 版本的 UMD 包可能存在模块解析差异;
- 更关键的是:Bootstrap 官方文档明确要求 jQuery ≥ 3.2.1 且 ≤ 3.5.x,推荐使用非-slim 版本以保证完整功能(如 $.fn.data()、$.fn.trigger() 的健壮性)。
正确配置方案
请将底部 <script> 块替换为以下<strong>经官方验证兼容的组合(对应 Bootstrap 4.2–4.6 主流版本):</script>
<!-- 1. jQuery(非 slim,3.2.1 是最稳定起点) --> <script src="https://code.jquery.com/jquery-3.2.1.min.js" integrity="sha256-hwg4gsxgFZhOsEEamdOYGBf13FyQuiTwlAQgxVSNgt4=" crossorigin="anonymous"></script><!-- 2. Popper.js(v1.14.7 是 Bootstrap 4 推荐稳定版) --><script src="https://cdn.jsdelivr.net/npm/popper.js@1.14.7/dist/umd/popper.min.js" integrity="sha384-ApNbgh9B+Y1QKtv3Rn7W3mgPxhU9K/ScQsAP7hUibX39j7fakFPskvXusvfa0b4Q" crossorigin="anonymous"></script><!-- 3. Bootstrap JS(与 CSS 版本严格一致,此处用 4.2.1) --><script src="https://cdn.jsdelivr.net/npm/bootstrap@4.2.1/dist/js/bootstrap.min.js" integrity="sha384-JZR6Spejh4U02d8jOt6vLEHfe/JQGiRRSQQxSfFWpi1MquVdAyjUar5+76PVCmYl" crossorigin="anonymous"></script>
✅ 关键要点总结:
- ✅ 禁用 slim 版 jQuery:改用完整版 jquery-3.2.1.min.js(或 3.3.1.min.js),避免 API 缺失;
- ✅ Popper.js 使用 1.14.7:比 1.14.6 修复了多个 UMD 加载边界问题;
- ✅ Bootstrap JS 版本必须与 CSS 版本完全一致(你用了 bootstrap/4.2.1/css,JS 就必须是 @4.2.1);
- ✅ 加载顺序不可颠倒:jQuery → Popper → Bootstrap JS(缺一不可,顺序错误将导致 $().collapse is not a function 错误);
- ✅ 检查浏览器控制台:若仍有问题,按 F12 查看 Console 是否报 Uncaught ReferenceError: $ is not defined(jQuery 未加载)或 collapse is not a function(Bootstrap JS 失效)。
? 提示:若项目允许升级,建议直接采用 Bootstrap 4.6.4(最终维护版),其对现代 jQuery 兼容性更优,并使用官方 CDN:
<script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1/dist/jquery.min.js"></script><script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.1/dist/umd/popper.min.js"></script><script src="https://cdn.jsdelivr.net/npm/bootstrap@4.6.4/dist/js/bootstrap.min.js"></script>
完成上述修正后,刷新页面并缩小浏览器窗口至手机尺寸,点击汉堡图标即可正常展开导航菜单。这是 Bootstrap 4 响应式开发中最典型、也最容易快速修复的“零配置失败”问题。











