Docker Compose 部署 Spring Boot 应用 502 Bad Gateway 问题排查与解决

问题描述

在使用 Docker Compose 部署周报系统后，前端访问登录接口时出现 502 Bad Gateway 错误：

POST http://172.16.xxx.xxx:5173/api/login 502 (Bad Gateway)

前端控制台错误信息：

AxiosError:Request failedwithstatus code502atot(request-BdhJx_rg.js:3:1078)at XMLHttpRequest.E(request-BdhJx_rg.js:3:5798)

问题分析

1. 502 Bad Gateway 错误含义

502 Bad Gateway 表示 Nginx 作为反向代理无法连接到后端服务。常见原因包括：

• 后端容器未启动或已崩溃
• 后端服务监听端口配置错误
• 后端服务启动失败
• 网络连接问题

2. 排查步骤

第一步：检查容器状态

docker-composeps

所有容器是否都在运行，不应该啊！！！？？

第二步：查看后端日志

docker-composelogs backend --tail=100

关键发现：

weekly-backend | no main manifest attribute, in app.jar weekly-backend | no main manifest attribute, in app.jar weekly-backend | no main manifest attribute, in app.jar ...

这个错误信息表明：jar 包中缺少主清单属性，导致 Java 无法找到主类来启动应用程序。

为什么？我明明存在该jar包，为什么会出现缺少主清单的app.jar

进一步分析

1. 检查 jar 包清单文件

unzip-p weekly.jar META-INF/MANIFEST.MF

发现的问题：

Manifest-Version: 1.0 Created-By: Maven JAR Plugin 3.4.1 Build-Jdk-Spec: 11

啊？为什么清单文件内容不完整，缺少了 Spring Boot 可执行 jar 包所需的关键属性。

2. 正确的清单文件应该包含

Manifest-Version: 1.0 Created-By: Maven JAR Plugin 3.4.1 Build-Jdk-Spec: 11 Main-Class: org.springframework.boot.loader.JarLauncher ← 缺少 Start-Class: com.example.SpringbootApplication ← 缺少 Spring-Boot-Version: 2.6.13 ← 缺少 Spring-Boot-Classes: BOOT-INF/classes/ ← 缺少 Spring-Boot-Lib: BOOT-INF/lib/ ← 缺少

3. 根本原因

检查pom.xml文件发现配置错误：

<plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><version>${spring-boot.version}</version><configuration><mainClass>com.example.Car-endApplication</mainClass>← 主类名称错误<skip>true</skip>← 跳过构建</configuration><executions><execution><id>repackage</id><goals><goal>repackage</goal></goals></execution></executions></plugin>

问题分析：

1. 主类名称错误：com.example.Car-endApplication应该是com.example.SpringbootApplication
2. 跳过构建：<skip>true</skip>导致打包时跳过了 Spring Boot Maven Plugin 的 repackage 阶段
3. 结果：生成的是普通 jar 包而不是可执行的 Spring Boot fat jar

如果pom.xml文件没有发现配置错误？那就是IDEA受网络波动影响导致打包一半（作者就是出现这个原因，真的是百思不得其解！气死了)

解决方案

1. 修复 pom.xml 配置

<plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><version>${spring-boot.version}</version><configuration><mainClass>com.example.SpringbootApplication</mainClass></configuration><executions><execution><id>repackage</id><goals><goal>repackage</goal></goals></execution></executions></plugin>

修改内容：

• 修正主类名称：com.example.Car-endApplication→com.example.SpringbootApplication
• 删除跳过构建配置：移除<skip>true</skip>

2. 重新打包项目

在本地开发机器上执行：

cdd:\jiangcaidu\code\周报\Weekly_end# 清理并重新打包mvn clean package -DskipTests

3. 验证打包结果

# 查看 jar 包大小dirtarget\Weekly_end-0.0.1-SNAPSHOT.jar# 查看清单文件jar xf target\Weekly_end-0.0.1-SNAPSHOT.jar META-INF\MANIFEST.MFtypeMETA-INF\MANIFEST.MF

正确的清单文件：

Manifest-Version: 1.0 Created-By: Maven JAR Plugin 3.4.1 Build-Jdk-Spec: 11 Main-Class: org.springframework.boot.loader.JarLauncher Start-Class: com.example.SpringbootApplication Spring-Boot-Version: 2.6.13 Spring-Boot-Classes: BOOT-INF/classes/ Spring-Boot-Lib: BOOT-INF/lib/ Spring-Boot-Classpath-Index: BOOT-INF/classpath.idx Spring-Boot-Layers-Index: BOOT-INF/layers.idx

终于是正确了！

jar 包特征：

• 文件大小：50MB - 100MB（包含所有依赖）
• 清单文件包含Main-Class和Start-Class

4. 接着上传新的 jar 包到服务器

# 在服务器上，备份旧的 jar 包mvweekly.jar weekly.jar.backup# 上传新的 jar 包到这个目录，并重命名为 weekly.jar

5. 重新构建 Docker 镜像

关键步骤：必须重新构建 Docker 镜像，因为 Dockerfile 中的COPY weekly.jar app.jar会在构建时将 jar 包复制到镜像内部。

# 停止并删除旧容器docker-composedown# 重新构建后端镜像（使用新的 jar 包）docker-composebuild backend# 启动服务docker-composeup -d# 查看后端日志docker-composelogs backend -f

6. 验证服务启动成功

后端启动成功后，日志应该显示：

. ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v2.6.13) ... Started SpringbootApplication in X.XXX seconds (JVM running for X.XXX)

参考资源

• Spring Boot Maven Plugin 文档
• Dockerfile 最佳实践
• Docker Compose 文档
• Maven 打包指南

---

如果部署中遇到502 Bad Gateway，觉得有帮助，欢迎点赞收藏！有问题欢迎评论区交流~