Next.js 13.2 App目录下Mongoose依赖缺失错误修复求助

这些报错的模块是MongoDB驱动的可选依赖，仅在Node.js环境下提供性能优化或特定功能支持，Next.js在客户端渲染环节尝试解析所有导入模块时会触发这类错误。以下是具体解决步骤：

1. 强制数据库连接逻辑仅在服务器端执行 #

Next.js App目录中，组件默认是React Server Components（RSC），但如果你的数据库连接代码被客户端组件间接引用，就会触发问题：

• 在数据库连接文件（比如./Total/db/connect.js）顶部添加'use server'指令，明确标记该文件仅在服务器端运行；
• 确保所有调用mongoose的逻辑，都放在服务器端组件、API路由或服务器端函数中，不要在带'use client'标记的客户端组件里直接导入mongoose。

2. 配置Next.js Webpack忽略可选依赖 #

在next.config.js中添加webpack配置，告诉构建工具忽略这些客户端不需要的可选依赖：

/** @type {import('next').NextConfig} */
const nextConfig = {
  webpack: (config, { isServer }) => {
    // 仅在客户端构建时忽略这些模块
    if (!isServer) {
      config.resolve.fallback = {
        ...config.resolve.fallback,
        'bson-ext': false,
        'kerberos': false,
        '@mongodb-js/zstd': false,
        'aws-crt': false
      };
    }
    return config;
  },
};

module.exports = nextConfig;

3. 清理缓存并重新构建 #

执行以下命令清理缓存和依赖，重新安装构建：

# Linux/Mac
rm -rf .next node_modules package-lock.json yarn.lock
npm install
npm run build

# Windows
rd /s /q .next node_modules
del package-lock.json yarn.lock
npm install
npm run build

补充说明 #

这些被忽略的模块属于MongoDB驱动的可选增强项，忽略后不会影响数据库的基础连接和操作，驱动会自动降级使用纯JavaScript实现。如果后续需要用到高性能BSON解析、Kerberos认证等特定功能，再单独安装对应模块即可。

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