部署Express GraphQL API至Elastic Beanstalk遇权限及502错误求助

一、解决IAM角色权限警告 #

你遇到的Access denied while accessing Auto Scaling using role警告，核心问题是服务角色的信任关系和权限配置错误：

1. 修正信任关系主体
   当前你的aws-elasticbeanstalk-service-role信任的是ec2.amazonaws.com，但Elastic Beanstalk服务角色的合法信任主体应为elasticbeanstalk.amazonaws.com。修改信任关系为：

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Principal": {
                   "Service": "elasticbeanstalk.amazonaws.com"
               },
               "Action": "sts:AssumeRole",
               "Condition": {
                   "StringEquals": {
                       "sts:ExternalId": "elasticbeanstalk"
                   }
               }
           }
       ]
   }
   

2. 附加必要权限
   给该服务角色附加AWS托管策略AWSElasticBeanstalkServicePolicy，这个策略包含了Elastic Beanstalk管理Auto Scaling、EC2等资源所需的完整权限，避免手动配置遗漏。

二、解决502 Bad Gateway错误 #

本地运行正常但部署后出502，按以下优先级排查：

1. 检查应用监听端口
   Elastic Beanstalk的Node.js环境默认要求应用监听5000端口（由环境变量PORT指定）。确保你的Express代码使用动态端口：

   const port = process.env.PORT || 5000; // 禁止硬编码3000等自定义端口
   app.listen(port, () => {
       console.log(`Server running on port ${port}`);
   });
   

2. 确认部署包包含dist目录
   如果项目用TypeScript编译到dist目录，务必确保部署包包含dist文件夹和package.json。若用git部署，检查.gitignore是否误排除了dist，导致编译文件缺失。
3. 验证启动脚本与Node版本
   • 确认package.json的start脚本node ./dist/index.js路径正确，Elastic Beanstalk会自动执行该脚本启动应用。
   • 检查Elastic Beanstalk环境的Node.js版本与本地一致，版本不兼容可能导致启动失败。可在项目根目录创建.nvmrc文件指定版本，比如18.17.0。
4. 查看应用日志定位问题
   登录Elastic Beanstalk控制台，进入目标环境后点击左侧「日志」→「请求日志」→「最近的日志」，重点关注：
   • 若出现Error: Cannot find module './dist/index.js'，说明dist目录未上传或路径错误。
   • 若有依赖缺失提示，检查package.json的dependencies是否包含所有生产必需的包，开发依赖需放在devDependencies中（部署时Elastic Beanstalk会跳过安装）。
5. 检查安全组配置
   • 实例安全组需允许Elastic Beanstalk负载均衡访问应用端口（默认5000）。
   • 负载均衡安全组需允许外部访问80（HTTP）或443（HTTPS）端口。

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