Netlify：仓库嵌套文件夹内的Create React App部署失败如何解决？

架构老林

2026-5-28

排查Create React App前后端分离仓库部署失败的问题

我处理过不少这类前后端分离仓库的部署问题，结合你的配置，咱们一步步来排查：

先确认本地构建是否正常
别着急看部署平台，先在你的本地仓库根目录手动执行cd frontend && npm run build，看看能不能顺利生成frontend/build文件夹。如果本地都报错，那问题肯定出在代码、依赖或者前端项目配置上——比如有没有语法错误？有没有缺失的环境变量？先把本地构建的问题解决，再去调试部署。
检查部署命令是否遗漏依赖安装
很多部署平台默认不会自动安装子目录的依赖，你当前的命令cd frontend && npm run build跳过了npm install步骤，要是平台没缓存过node_modules，肯定会因为缺少依赖而构建失败。建议把命令改成：
```
cd frontend && npm install && npm run build
```
要是担心安装速度，有些平台支持缓存node_modules，你可以在平台设置里开启这个选项，之后就能省略每次的install步骤了。
验证Node.js版本是否符合要求
Create React App对Node版本有最低要求（比如最新版本的CRA需要Node 14.0.0以上），如果部署平台用的Node版本太低，会导致依赖安装或构建失败。你可以在frontend/package.json里添加engines字段来指定版本：
```
"engines": {
  "node": ">=14.0.0",
  "npm": ">=6.0.0"
}
```
同时去部署平台的设置里确认Node版本是否匹配，或者手动指定版本。
一定要看部署日志的错误详情
这是最容易被忽略但最关键的一步！部署失败时，平台肯定会给出详细的日志信息——是依赖安装时报错？还是build过程中出现编译错误？比如如果你的前端用到了自定义环境变量，部署时必须在平台的环境变量设置里配置好，否则CRA会因为找不到变量而构建失败。
确认发布目录的配置是否正确
你填的frontend/build是相对仓库根目录的路径，大部分平台都支持这种写法，但要确保构建完成后这个目录确实存在，并且里面有index.html等静态文件。有些平台可能会把发布目录的路径解析成相对于工作目录的，你可以在日志里看看平台实际读取的路径是什么，有没有和你配置的一致。

如果以上步骤都试过还是不行，把部署日志里的关键错误信息贴出来，咱们再针对性解决。

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