如何在AWS部署Node.js API？EC2部署后npm start报错求助

DevOps 小满

2026-7-12

排查AWS EC2上Node.js API npm start 报错的方案

Node.js/npm版本不一致
本地和EC2实例的Node.js、npm版本可能存在差异，部分依赖包对版本有严格要求。分别在本地和EC2上执行node -v和npm -v对比版本，若不一致，建议用nvm管理多版本：
```
# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重启终端后安装与本地相同的版本（示例为v18.17.0）
nvm install 18.17.0
nvm use 18.17.0
```
依赖包未正确安装
网络或系统环境可能导致EC2上依赖安装不完整，先清理现有依赖再重装：
```
rm -rf node_modules package-lock.json
npm install
```
若项目用yarn管理，同步删除yarn.lock后执行yarn install，确保依赖与本地完全匹配。
环境变量缺失
本地配置的数据库连接串、密钥等环境变量可能未同步到EC2。可临时导出变量：
```
export DB_URL="你的数据库地址"
export API_SECRET="你的密钥"
```
或创建.env文件，复制本地的环境变量内容（注意敏感信息防护）。
端口权限问题
若API使用80、443这类1024以下端口，普通用户无绑定权限。要么修改代码改用3000这类高位端口，要么用sudo启动服务：
```
sudo npm start
```
也可通过端口转发实现低端口访问：
```
sudo iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 3000
```
系统依赖缺失
部分Node.js包（如bcrypt）需要系统编译工具支持，以Amazon Linux 2为例安装依赖：
```
sudo yum install gcc-c++ make python3
```
Ubuntu系统则执行：
```
sudo apt-get update
sudo apt-get install build-essential python3
```
查看详细错误日志
直接执行npm start的报错信息可能不够具体，可通过以下方式获取详细日志：
```
npm start --verbose
# 或直接运行入口文件查看完整错误输出
node app.js 2>&1
```
根据具体错误提示（如模块缺失、数据库连接失败）针对性解决。