Next.js中无法解析'fs'模块求助：better-sqlite3依赖反复报错

项目引入better-sqlite3依赖后原本运行正常，后期反复出现无法解析'fs'模块的错误，已尝试重新安装依赖、清除缓存等操作但未解决，可尝试以下方案：

1. 适配前端构建环境配置 #

better-sqlite3是Node.js专属模块，前端构建工具（如Vite、Webpack）默认不支持Node核心模块（如fs），需添加polyfill或配置：

• Vite：在vite.config.js中添加配置

  import { defineConfig } from 'vite'
  export default defineConfig({
    resolve: {
      alias: {
        'fs': 'rollup-plugin-node-polyfills/polyfills/fs'
      }
    },
    optimizeDeps: {
      include: ['better-sqlite3']
    }
  })
  

  同时安装依赖：npm install rollup-plugin-node-polyfills --save-dev
• Webpack：在webpack.config.js中配置

  module.exports = {
    resolve: {
      fallback: {
        'fs': require.resolve('fs-browserify'),
        'path': require.resolve('path-browserify')
      }
    }
  }
  

  安装依赖：npm install fs-browserify path-browserify --save-dev

2. 确认Node.js版本兼容性 #

better-sqlite3对Node.js版本有明确要求，建议使用LTS版本（如18.x、20.x）：

• 用nvm切换版本：

  nvm install 20 && nvm use 20
  

• 切换后重新安装依赖：npm install

3. 重新安装完整依赖 #

网络问题可能导致依赖安装不完整，执行以下步骤：

rm -rf node_modules package-lock.json
npm cache clean --force
npm install

若用yarn：

rm -rf node_modules yarn.lock
yarn cache clean
yarn install

4. 适配ES模块环境 #

若项目设置了"type": "module"，需调整better-sqlite3的导入方式：

import BetterSqlite3 from 'better-sqlite3'
const db = new BetterSqlite3.default('./database.db')

或在Vite中强制预构建依赖：

export default defineConfig({
  optimizeDeps: {
    force: true
  }
})

5. 检查代码工具配置 #

• TypeScript：确保tsconfig.json中moduleResolution设为node：

  {
    "compilerOptions": {
      "moduleResolution": "node"
    }
  }
  

• ESLint：在.eslintrc.json中开启Node环境：

  {
    "env": {
      "node": true
    }
  }
  

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