AWS Elastic Beanstalk环境更新耗时过长 如何排查？

1. 优先排查EC2实例内部日志 #

直接登录运行中的EC2实例，查看核心日志定位卡环节点：

• 查看Node.js应用运行日志：tail -f /var/log/nodejs/nodejs.log，检查是否有启动失败、语法错误、端口占用或依赖缺失的报错
• 查看EB部署引擎日志：tail -f /var/log/eb-engine.log，这是EB部署流程的核心日志，能看到部署到哪一步卡住（比如npm安装超时、钩子脚本执行失败）
• 查看EB钩子执行日志：tail -f /var/log/eb-hooks.log，检查自定义.ebextensions或平台钩子是否有异常
• 查看系统内核日志：tail -f /var/log/messages，排查是否有OOM（内存耗尽）、磁盘满、进程崩溃等系统级问题

2. 验证健康检查配置匹配性 #

EB持续等待实例就绪的常见原因是健康检查不通过：

• 确认Node.js应用监听的端口与EB配置一致：执行eb config查看PORT环境变量，检查package.json的start脚本是否监听该端口
• 检查EB健康检查路径：默认是根路径/，如果你的应用根路径返回非200状态，或自定义了健康检查路径，需确保路径能正常返回200
• 手动在实例内部测试健康检查：执行curl http://localhost:${PORT}/health（替换为你的健康路径），确认返回状态正常

3. 排查依赖安装环节 #

Node.js部署卡住常出现在依赖安装阶段：

• 本地执行npm install --production，验证依赖是否能正常安装，排除代码层面的版本冲突或包缺失问题
• 在EC2实例测试npm registry连通性：curl https://registry.npmjs.org，若无法访问，排查子网NAT网关、安全组出口规则是否正常
• 查看eb-engine.log中npm安装的耗时，若耗时过长，可考虑将依赖包缓存到S3，或使用镜像源加速

4. 检查实例资源状态 #

EC2实例运行但无健康数据，可能是资源耗尽导致进程异常：

• 查看CPU/内存占用：top或htop，若内存使用率接近100%，可能Node.js进程被OOM killer杀掉，需调整实例规格或优化应用内存占用
• 检查磁盘空间：df -h，若根目录/使用率超过90%，会导致部署脚本无法写入文件，需清理日志或临时文件

5. 排查EB环境配置漂移或缓存问题 #

未变更代码但突然异常，可能是配置漂移或缓存残留：

• 清理EB实例临时缓存：rm -rf /tmp/eb/*，重新触发部署
• 检查.ebextensions目录下的自定义脚本，是否存在死循环、超时逻辑，或脚本执行依赖的资源已失效
• 尝试使用eb deploy --staged命令，强制重新打包部署，避免本地缓存影响

6. 验证网络与负载均衡配置 #

• 检查安全组规则：确保ELB所在安全组能访问EC2实例的应用端口，EC2实例安全组允许出站访问外网（用于依赖安装）
• 检查ELB健康检查配置：确认ELB的健康检查端口、路径与应用一致，若ELB标记实例为不健康，EB会持续等待实例恢复

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