部署Node.js AI项目时node-faiss与libomp安装问题求助

1. 将libomp纳入项目路径的操作步骤 #

• 手动复制libomp库文件到项目：
  1. 找到本地libomp的位置：
     • macOS：/usr/local/opt/libomp/lib/libomp.dylib
     • Linux：/usr/lib/x86_64-linux-gnu/libomp.so
     • Windows：C:\Program Files\LLVM\bin\libomp.dll
  2. 在项目根目录新建lib文件夹，将对应平台的libomp文件复制进去。
  3. 修改启动命令指定库路径：
     • Linux/macOS：在package.json的scripts中设置：

       "start": "LD_LIBRARY_PATH=./lib node server.js"
       

     • Windows：

       "start": "set PATH=./lib;%PATH% && node server.js"
       

2. 修复faiss-node未找到的核心方案 #

• 禁止上传本地node_modules：
  本地编译的faiss-node依赖本地系统架构，部署平台环境不同会导致不兼容，必须让平台重新安装并编译依赖。
• 针对Vercel平台的配置：
  1. 在项目根目录创建vercel.json文件，添加构建时安装libomp的命令：

     {
       "buildCommand": "apt-get update && apt-get install -y libomp-dev && npm install",
       "functions": {
         "api/**/*.js": {
           "runtime": "@vercel/node@20"
         }
       }
     }
     

  2. 确保package.json中faiss-node在dependencies字段下，而非devDependencies。
• 针对Render平台的配置：
  在Render的部署设置中，将构建命令修改为：

  apt-get update && apt-get install -y libomp-dev && npm install && npm run build
  

• 替代方案：使用faiss-wasm
  如果编译问题持续，可替换为纯WebAssembly实现的faiss-wasm，无需系统库依赖：
  1. 卸载faiss-node：npm uninstall faiss-node
  2. 安装faiss-wasm：npm install faiss-wasm
  3. 修改代码中的导入语句：

     import { IndexFlatL2 } from 'faiss-wasm';
     

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