Next.js生产环境部署报错：TypeError: jsxDEV is not a function求助

报错原因 #

jsxDEV是React开发模式下的专用JSX转换函数，生产环境中React会自动切换到jsx函数。该报错说明生产环境的构建产物中错误引入了开发模式的React运行时，常见触发场景：

• 云端部署时NODE_ENV未正确设置为production，或构建脚本误用了开发模式命令（如next dev）
• React、React DOM与Next.js版本不兼容，导致运行时函数不匹配（比如Next.js 12+要求React 17+）
• 云端依赖缓存未清理，旧的开发模式依赖包被带入生产构建
• 自定义Webpack配置错误，强制启用了开发模式或引入了开发专用模块

解决办法 #

• 确认生产模式构建配置
  • 检查云端部署的构建命令是否为next build，启动命令为next start；同时确保构建阶段NODE_ENV=production环境变量已正确配置（部分平台需手动在环境变量面板设置）
• 对齐依赖版本
  • 查看package.json中react、react-dom和next的版本，执行npm list react react-dom next确认版本兼容性。例如Next.js 13.x需搭配React 18.x，Next.js 12.x需搭配React 17.x，不兼容则升级/降级到匹配版本
• 清理依赖缓存
  • 在云端构建流程中添加缓存清理步骤，比如构建前执行：

    rm -rf node_modules .next
    npm cache clean --force
    

• 检查自定义Webpack配置
  • 若项目有next.config.js，确认未手动设置mode: 'development'，也未直接引入react/jsx-dev-runtime等开发模块，确保Webpack模式跟随Next.js生产构建逻辑
• 本地模拟生产环境验证
  • 本地执行next build && next start启动生产模式服务，若能复现问题则排查本地依赖或配置；若本地正常则聚焦云端部署的环境变量、缓存或构建脚本问题

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