本地npm run build运行正常,生产服务器执行该命令报错求助
React生产环境执行
npm run build报错排查 先列几个最可能的原因和对应解决方法:
- Node.js版本不匹配:本地和生产服务器的Node版本差异过大,
react-scripts对Node版本有明确要求(不同版本的react-scripts对应Node v14~v18不等)。先在本地执行node -v查看版本,再同步生产服务器的Node版本,用nvm管理版本会更便捷。 - 依赖未正确安装:生产服务器拉取代码后,必须先执行
npm ci(严格按照package-lock.json安装依赖,比npm install更稳定)。如果之前安装过依赖,建议先删除node_modules和package-lock.json再重新安装。 - 环境变量缺失:本地开发时可能配置了
REACT_APP_开头的环境变量,生产服务器未配置会导致build时找不到变量报错。检查生产服务器的环境变量配置,补上必要项或在代码中设置默认值兜底。 - 文件权限不足:生产服务器项目目录权限不够,会导致build过程无法生成文件或读取依赖。给项目目录设置合适权限,比如执行
chmod -R 755 你的项目目录。 - Git忽略文件遗漏:检查
.gitignore是否误忽略了必要配置文件(比如.env.production),导致生产服务器缺失关键文件。将需要的文件从.gitignore移除,或手动上传到生产服务器。
你的scripts配置是标准的Create React App模板配置,问题大概率不在这部分。
内容的提问来源于stack exchange,提问作者M.Sahar
相关产品推荐
相关产品推荐

