AWS Elastic Beanstalk部署Spring Boot项目失败求助

我之前部署Spring Boot到Elastic Beanstalk时也踩过类似的坑，结合常见问题给你梳理几个排查方向，应该能帮你定位问题：

1. 先拉取完整日志定位错误根源 #

本地正常但云端跑不起来，日志是唯一能直接看到问题的入口：

• 登录AWS控制台进入你的Beanstalk环境，找到Logs选项卡，选择「Request Logs」→「Full Logs」下载完整日志包
• 重点查看这两个日志文件：
  • /var/log/web-1.log：Tomcat（或Spring Boot内置容器）的运行日志，找ERROR或Exception关键词，比如端口冲突、依赖缺失
  • /var/log/eb-engine.log：Beanstalk部署引擎的日志，看有没有部署阶段的报错，比如文件权限、打包格式不兼容

2. 确认Spring Boot打包方式与端口配置 #

打包格式匹配Beanstalk规则 #

Beanstalk对JAR和WAR包的处理逻辑完全不同，你得确保打包方式和配置对应：

• 如果是可执行JAR（推荐）：必须在pom.xml里配置Spring Boot插件，确保打包后是独立可运行的JAR：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>你的Spring Boot版本号</version>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

• 如果是WAR包：需要修改启动类继承SpringBootServletInitializer，同时排除内置Tomcat依赖（用Beanstalk自带的Tomcat）：

<packaging>war</packaging>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <exclusions>
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-tomcat</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

端口必须匹配Beanstalk环境 #

Beanstalk的Java环境默认监听8080端口，你需要确保项目端口和这个一致：

• 在application.properties里设置：server.port=8080
• 或者在Beanstalk环境的「Configuration」→「Software」→「Environment properties」中添加SERVER_PORT=8080

3. 检查Beanstalk环境基础配置 #

• JDK版本匹配：确认你的Beanstalk环境使用的JDK版本和本地一致（比如本地用Corretto 17，云端就别选Corretto 8），版本不兼容会直接导致启动失败
• 实例资源足够：如果用的是t2.micro这类低配实例，可能会因为内存不足启动失败，日志里会出现OutOfMemoryError，可以临时切换到t2.small测试

4. 本地模拟Beanstalk环境测试 #

你可以用Docker模拟Beanstalk的Java运行环境，验证项目本身有没有云端特有的问题：

# 假设你的JAR包名为demo.jar，用对应版本的Corretto镜像
docker run -p 8080:8080 amazoncorretto:17 java -jar demo.jar

5. 开启详细日志输出 #

如果极简项目的日志太少，看不到启动细节，可以在application.properties里调高日志级别：

logging.level.root=INFO
logging.level.org.springframework=DEBUG

这样能看到Spring Boot启动过程中每一步的加载情况，更容易定位卡点

如果可以的话，把完整的pom.xml内容贴出来，能帮你更精准地排查问题。

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