添加Metronic模板后Elastic Beanstalk出现502 Bad Gateway nginx错误

以下是针对你的场景的具体排查和修复步骤：

• 优先提取并分析日志
  登录 Elastic Beanstalk 控制台，进入目标环境，下载完整日志包，重点检查：

  • /var/log/nginx/error.log：查找 502 错误的触发细节，比如 nginx 无法连接后端应用端口、静态资源访问权限问题
  • /var/log/web.stdout.log：查看 Spring Boot 应用启动日志，确认是否存在 Metronic 相关的资源加载失败、模板解析错误或依赖冲突
  • /var/log/web.stderr.log：检查应用运行时的异常输出，比如类加载失败、配置文件解析错误

• 验证 Metronic 静态资源打包与路径配置

  • 确认 Metronic 的 css、js、字体、图片等静态资源是否被正确打包到 Spring Boot 构建产物的 target/classes/static 或 target/classes/public 目录
  • 检查模板文件中对静态资源的引用路径，避免使用本地开发时的相对路径（如 ../），改用 Spring Boot 支持的绝对路径（如 /css/metronic/xxx.css）
  • 排查是否存在资源文件名大小写问题（Linux 环境区分大小写，本地 Windows/macOS 可能不区分）

• 确认 Spring Boot 启动状态与端口配置

  • Elastic Beanstalk 默认监听后端应用的 5000 端口，确保 application.properties 中 server.port 设为 5000，或通过 EB 环境变量指定了正确端口
  • 登录 EC2 实例，进入 /var/app/current 目录，手动执行 java -jar your-app.jar，观察应用是否能正常启动，记录启动过程中的报错信息
  • 检查是否存在 Metronic 依赖与 Spring Boot 3.1.1、Java 17 的兼容性问题，比如旧版 Metronic 配套的后端代码不支持 Java 17 的新特性

• 调整 Nginx 配置（若必要）

  • 502 错误常因 nginx 无法连接后端应用，查看 /etc/nginx/conf.d/elasticbeanstalk/00_application.conf，确认 proxy_pass 指向的端口与 Spring Boot 监听端口一致
  • 若应用启动较慢，可通过 .ebextensions 目录添加配置文件延长 nginx 超时时间：

    files:
      /etc/nginx/conf.d/timeout.conf:
        content: |
          proxy_connect_timeout 60s;
          proxy_send_timeout 60s;
          proxy_read_timeout 60s;
    

  • 部署后执行 sudo service nginx restart 生效配置

• 检查静态资源文件权限
  登录 EC2 实例，查看 /var/app/current/static 下的 Metronic 文件权限，确保 nginx 用户拥有读取权限，可执行 chmod -R 644 /var/app/current/static 统一设置权限

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