使用NextJS 13搭配Langchain推荐的VectorStore时出现HNSWLib未安装错误

1. 确认依赖安装状态 #

• 检查项目根目录的package.json，确认hnswlib-node已在dependencies中（而非devDependencies），版本建议匹配LangChain要求（如^1.4.2及以上）。
• 执行npm list hnswlib-node，验证包是否正确安装到项目本地，避免全局安装或子目录安装导致的路径问题。

2. 配置Next.js Webpack处理原生模块 #

hnswlib-node是Node.js原生模块，Next.js的Webpack打包可能会误处理，需在next.config.js中添加外部依赖配置：

/** @type {import('next').NextConfig} */
const nextConfig = {
  webpack: (config, { isServer }) => {
    // 仅在服务端打包时标记为外部依赖
    if (isServer) {
      config.externals.push({
        'hnswlib-node': 'commonjs hnswlib-node',
      });
    }
    return config;
  },
};

module.exports = nextConfig;

配置后重启开发服务器，让Webpack直接使用Node.js的require加载该模块，而非打包进客户端代码。

3. 改用动态导入HNSWLib #

静态导入可能触发Webpack提前解析模块，尝试在API路由的GET函数内部动态导入：

// 移除顶部的静态导入
// import { HNSWLib } from 'langchain/vectorstores/hnswlib';

export const GET = async (req: NextRequest) => {
  // ... 其他代码
  // 动态导入HNSWLib
  const { HNSWLib } = await import('langchain/vectorstores/hnswlib');
  const vectorStore = await HNSWLib.fromDocuments(docs, new OpenAIEmbeddings({ openAIApiKey: apiKey }));
  // ... 剩余代码
};

4. 验证Node.js版本兼容性 #

hnswlib-node要求Node.js版本≥16.x，执行node -v检查当前版本，若低于要求，升级至LTS版本（如v18或v20）。

5. 彻底清理缓存并重建 #

执行以下命令清除所有缓存后重新安装依赖：

rm -rf node_modules .next package-lock.json
npm install
npm run build
npm run dev

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