容器部署springboot项目--入门

1. 环境准备

确认安装docker desktop，参考docker desktop安装

2. 项目准备

2.1 springboot项目

完成springboot项目，确保可以打包为可执行jar
pom.xml 关键配置

 <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

项目打包

# Maven 项目
mvn clean package -DskipTests

# Gradle 项目
./gradlew clean build -x test

2.2 创建 Dockerfile文件

# 使用基础的 Java 镜像
FROM eclipse-temurin:21-jdk-alpine

# 设置工作目录
WORKDIR /app
# 将打包好的 JAR 文件复制到容器中
COPY target/*.jar /app/app.jar

# 暴露 Spring Boot 应用的端口
EXPOSE 8080

# 运行 Spring Boot 应用
CMD ["java", "-jar", "app.jar"]

2.3 构建 Docker 镜像

docker build -t my-spring-app:1.0.0 .

2.4 运行docker镜像

docker run -d \
  --name spring-app \
  -p 8080:8080 \
  my-spring-app:1.0.0

3. 调试

3.1 进入容器调试：

docker exec -it spring-app sh

3.2 查看应用日志：

docker logs --tail 100 -f spring-app

3.3 端口检查：

# 容器内部
docker exec spring-app nc -zv localhost 8080

# 宿主机
curl http://localhost:8080/actuator/health

4. 常见问题解决

4.1 Spring Boot 应用在打包/启动阶段无法连接 Docker 容器中的 Redis

1. 打包时不连接 Redis，运行时通过环境变量注入真实地址。其他类似容器服务也可以

# application.yml
spring:
  redis:
    host: ${REDIS_HOST:localhost}  # 默认localhost，可由环境变量覆盖
    port: ${REDIS_PORT:6379}

2. 启动容器时确保java项目和redis服务在同一个网络，可以参考docker 容器通信

docker run -d \
  --name spring-app \
  -p 8080:8080 \
  -e REDIS_HOST=redis-server \  # Docker 容器名
  -e REDIS_PORT=6379 \
  --net subnetwork \
  --ip 192.168.0.5  \
  my-spring-app:1.0.0

4.2 项目打包后未包含直接引用的本地 JAR 文件

项目结构：

project-root/
├── libs/           # 存放自定义JAR
│   └── custom-lib-1.0.0.jar
├── src/
└── pom.xml

更新 pom.xml 文件配置，在build->plugins-plugin节点增加 configuration 节点

<dependencies>
    <!-- 自定义依赖 -->
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>custom-lib</artifactId>
        <version>1.0.0</version>
        <scope>system</scope>
        <systemPath>${project.basedir}/libs/custom-lib-1.0.0.jar</systemPath>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <!-- 关键：包含系统作用域依赖 -->
                <includeSystemScope>true</includeSystemScope>
            </configuration>
        </plugin>
    </plugins>
</build>