共享服务器Node.js版本不兼容Next.js问题求助

1. 匹配Next.js与Node.js 14.21.2的兼容版本 #

Next.js 13.4及以上版本强制要求Node.js 18.17.0+，你必须降级到Next.js 12.x系列（最高12.3.4），该版本完全兼容Node.js 14：

• 执行降级命令：

  npm install next@12.3.4 react@18.2.0 react-dom@18.2.0
  

• 确认package.json配置：

  "engines": {
    "node": "14.21.2",
    "npm": ">=6.14.17"
  },
  "dependencies": {
    "next": "^12.3.4",
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  }
  

2. 确保NVM在cPanel的shell环境中生效 #

cPanel默认使用csh/tcsh，而NVM默认初始化脚本适配bash/zsh，可能导致版本切换不生效：

• 执行nvm version确认当前生效版本，若不是14.21.2，配置csh环境：
  1. 创建~/.cshrc文件并添加：

     setenv NVM_DIR $HOME/.nvm
     source $NVM_DIR/nvm.sh
     

  2. 重启shell或执行source ~/.cshrc，再切换版本：nvm use 14.21.2
• 关闭cPanel自带的Node.js管理器：在cPanel的「Select PHP Version」中禁用全局Node.js，避免与NVM版本冲突

3. 彻底清理依赖并重装 #

• 清理npm缓存：npm cache clean --force
• 删除旧依赖文件：rm -rf node_modules package-lock.json
• 重新安装依赖：npm install
• 注意：不要使用npm ci，它会强制依赖package-lock.json中的旧版本，可能导致兼容问题

4. 改用生产构建模式部署（cPanel推荐） #

next dev是开发模式，不适合托管服务器运行，应构建静态文件后部署：

• 执行构建命令：next build生成.next目录
• 创建启动脚本server.js：

  const { createServer } = require('http')
  const { parse } = require('url')
  const next = require('next')
  
  const dev = false
  const app = next({ dev })
  const handle = app.getRequestHandler()
  
  app.prepare().then(() => {
    createServer((req, res) => {
      const parsedUrl = parse(req.url, true)
      handle(req, res, parsedUrl)
    }).listen(3000, (err) => {
      if (err) throw err
      console.log('> Ready on http://localhost:3000')
    })
  })
  

• 在cPanel的「Node.js Selector」中设置启动文件为server.js，选择生产模式启动

5. 验证环境配置 #

执行以下命令确认环境变量正确：

• node -v：输出v14.21.2
• npm -v：输出Node.js 14配套的版本（约6.14.17）
• which node：路径应指向~/.nvm/versions/node/v14.21.2/bin/node，而非cPanel全局Node路径

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