
Bootstrap 5.3 中 navbar 下拉菜单无法展开,通常是因重复引入 JS 文件或错误加载 Popper 导致;只需保留 bootstrap.bundle.min.js(已内置 Popper),移除额外的 popper.min.js 和 bootstrap.min.js 即可修复。
bootstrap 5.3 中 navbar 下拉菜单无法展开,通常是因重复引入 js 文件或错误加载 popper 导致;只需保留 `bootstrap.bundle.min.js`(已内置 popper),移除额外的 `popper.min.js` 和 `bootstrap.min.js` 即可修复。
在 Bootstrap 5.x 中,下拉(Dropdown)、弹出框(Popover)、提示框(Tooltip)等组件依赖 Popper.js 实现定位逻辑。但 Bootstrap 官方明确区分了两种 JS 分发包:
- bootstrap.min.js:不包含 Popper,需手动引入 Popper(v2)才能工作;
- bootstrap.bundle.min.js:已内置 Popper(通过 @popperjs/core),开箱即用,推荐生产环境使用。
你原始代码中存在两个关键错误:
- ✅ 错误叠加引入:同时加载了 bootstrap.bundle.min.js、popper.min.js 和 bootstrap.min.js —— 这不仅冗余,更会引发脚本冲突或覆盖行为(如多次初始化同一组件);
- ❌ 冗余 Popper 加载:bootstrap.bundle.min.js 已含 Popper,单独再引入 popper.min.js 可能导致版本不兼容或事件绑定异常。
✅ 正确做法(精简且可靠)
仅保留以下三要素:
- Bootstrap CSS(必需)
- bootstrap.bundle.min.js(唯一 JS,含 Popper + 所有组件)
- HTML 结构符合 Bootstrap 5 语义(你的结构本身完全正确 ✅)
以下是修复后的最小可运行示例:
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Bootstrap Navbar Dropdown Fix</title>
<!-- Bootstrap 5.3 CSS -->
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet"
integrity="sha384-T3c6CoIi6uLrA9TneNEoa7RxnatzjcDSCmG1MXxSR1GAsXEV/Dwwykc2MPK8M2HN" crossorigin="anonymous">
</head>
<body>
<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent"
aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse" id="navbarSupportedContent">
<ul class="navbar-nav me-auto mb-2 mb-lg-0">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#">Home</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item dropdown">
<a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown
</a>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><hr class="dropdown-divider"></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
</ul>
</li>
</ul>
</div>
</div>
</nav>
<!-- ✅ 唯一必需的 JS:bootstrap.bundle.min.js -->
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"
integrity="sha384-C6RzsynM9kWDrMNeT87bh95OGNyZPhcTNXj1NW7RuBCsyN/o0jlpcV8Qyq46cDfL" crossorigin="anonymous">
</script>
</body>
</html>⚠️ 注意事项
- 不要混用 bundle 与独立 JS:若你选择 bootstrap.min.js,则必须显式引入兼容版本的 @popperjs/core(v2.11.x),且需确保加载顺序为 popper → bootstrap.min.js;
- 检查浏览器控制台:若仍不工作,请按 F12 打开开发者工具,查看 Console 是否报错(如 ReferenceError: Popper is not defined 或 Uncaught TypeError: Cannot read property 'toggle' of null),这能快速定位加载失败或 DOM 未就绪问题;
- 确保 DOM 就绪后再初始化:虽然 bootstrap.bundle.min.js 支持自动初始化,但若 JS 放在 中(未加 defer),请务必移至 底部,避免因 DOM 未加载完成导致组件绑定失败;
- 验证 CDN 链接有效性:文中使用的 CDN 地址为官方稳定版(@5.3.3),请勿使用带 [email protected] 占位符的混淆链接(你原始代码中存在此类被邮箱保护的伪 URL,需替换为真实路径)。
遵循以上规范后,Navbar 下拉菜单即可正常响应点击/悬停(默认为点击触发),无需任何额外 JavaScript 初始化。这是 Bootstrap 5 的标准实践,兼顾简洁性与可靠性。


















