Next.js App目录引入Bootstrap JS遇类型及客户端组件错误求助

1. 将 Layout 标记为客户端组件 #

Next.js 13+ 的 App Router 默认所有组件都是服务端组件，而 Bootstrap 的 JS 必须在浏览器端运行，useEffect 这类客户端钩子也只能在客户端组件里用。直接在 Layout.jsx 的最顶部添加一行：

'use client';

2. 解决类型声明错误 #

你碰到的找不到声明文件问题，是因为 Bootstrap 官方 JS 没自带 TypeScript 类型定义，安装对应的类型包就能解决：

npm install @types/bootstrap --save-dev

如果是纯 JavaScript 项目，这步可以跳过，但装了能避免编辑器报错，开发体验更好。

3. 正确导入 Bootstrap JS #

两种方式任选其一：

方式一：直接导入（简单高效） #

因为已经给 Layout 加了 use client，可以直接在文件里导入 Bootstrap JS：

'use client';

import './globals.css';
import 'bootstrap/dist/css/bootstrap.css';
import 'bootstrap/dist/js/bootstrap.js';

// 你的 Layout 组件代码...

方式二：动态加载（按需加载） #

如果想等组件挂载后再加载 JS，用 useEffect 动态导入：

'use client';

import { useEffect } from 'react';
import './globals.css';
import 'bootstrap/dist/css/bootstrap.css';

export default function RootLayout({ children }) {
  useEffect(() => {
    import('bootstrap/dist/js/bootstrap.js');
  }, []);

  return (
    // 你的布局结构...
  );
}

4. 检查下拉菜单的 HTML 结构 #

确保导航栏代码符合 Bootstrap 5 的规范，比如下拉按钮要加 data-bs-toggle="dropdown" 属性，示例结构：

<nav className="navbar navbar-expand-lg navbar-light bg-light">
  <div className="container-fluid">
    <a className="navbar-brand" href="#">导航栏</a>
    <button className="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarContent" aria-controls="navbarContent" aria-expanded="false" aria-label="切换导航">
      <span className="navbar-toggler-icon"></span>
    </button>
    <div className="collapse navbar-collapse" id="navbarContent">
      <ul className="navbar-nav me-auto mb-2 mb-lg-0">
        <li className="nav-item dropdown">
          <a className="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
            下拉菜单
          </a>
          <ul className="dropdown-menu">
            <li><a className="dropdown-item" href="#">选项1</a></li>
            <li><a className="dropdown-item" href="#">选项2</a></li>
            <li><hr className="dropdown-divider"/></li>
            <li><a className="dropdown-item" href="#">更多选项</a></li>
          </ul>
        </li>
      </ul>
    </div>
  </div>
</nav>

额外说明 #

• Bootstrap 5 的 JS 已经内置了 Popper.js，不需要额外安装 Popper 包。
• 如果不想把整个 Layout 改成客户端组件，也可以把导航栏单独抽成一个客户端组件（顶部加 use client），再在 Layout 里引入这个导航栏，更符合 App Router 的最佳实践。

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