1. 为什么需要Docker化SpringBoot与Flowable工作流引擎

在传统的开发模式中，部署一个包含工作流引擎的应用往往需要复杂的配置过程。记得我第一次在本地环境部署Flowable时，光是安装MySQL、配置数据源、设置环境变量就花了整整一个下午。更别提当需要迁移到服务器时，又要重新走一遍这个流程，简直是开发者的噩梦。

Docker的出现彻底改变了这种状况。通过将SpringBoot应用和Flowable工作流引擎打包成Docker镜像，我们可以实现：

• 环境一致性：开发、测试、生产环境完全一致，再也不会出现"在我机器上是好的"这种问题
• 快速部署：新环境部署只需拉取镜像运行即可，整个过程不超过5分钟
• 资源隔离：每个服务运行在独立的容器中，避免端口冲突和依赖冲突
• 弹性扩展：配合Kubernetes可以轻松实现工作流引擎的水平扩展

以一个请假审批流程为例，传统部署方式可能需要：

1. 安装JDK
2. 安装MySQL并创建数据库
3. 配置SpringBoot应用连接数据库
4. 启动应用并初始化Flowable表结构

而使用Docker后，整个过程简化为：

docker-compose up -d

2. 项目初始化与基础配置

2.1 创建SpringBoot项目

首先使用Spring Initializr创建一个基础项目，关键依赖包括：

• Spring Web
• Flowable Spring Boot Starter
• MySQL Driver

<dependency>
    <groupId>org.flowable</groupId>
    <artifactId>flowable-spring-boot-starter</artifactId>
    <version>6.7.0</version>
</dependency>

2.2 配置数据库连接

在application.yml中配置数据库连接，这里有个小技巧：使用环境变量代替硬编码的密码，方便后续Docker化：

spring:
  datasource:
    url: jdbc:mysql://${DB_HOST:localhost}:3306/flowable?useSSL=false
    username: ${DB_USER:root}
    password: ${DB_PASSWORD:123456}
    driver-class-name: com.mysql.cj.jdbc.Driver
flowable:
  database-schema-update: true

2.3 设计基础工作流

在resources/processes目录下创建请假流程定义文件leave-process.bpmn20.xml：

<process id="leaveProcess" name="请假流程">
    <startEvent id="startEvent"/>
    <userTask id="leaderTask" name="主管审批" flowable:assignee="${leader}"/>
    <sequenceFlow sourceRef="startEvent" targetRef="leaderTask"/>
    <endEvent id="endEvent"/>
    <sequenceFlow sourceRef="leaderTask" targetRef="endEvent"/>
</process>

3. Docker化SpringBoot应用

3.1 编写高效的Dockerfile

一个优化的Dockerfile能显著提升构建速度和运行效率。这是我经过多次实践总结的最佳方案：

# 第一阶段：构建
FROM maven:3.8.6-eclipse-temurin-17 as builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn package -DskipTests

# 第二阶段：运行
FROM eclipse-temurin:17-jre-jammy
WORKDIR /app
COPY --from=builder /app/target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java","-jar","app.jar"]

这个Dockerfile有以下几个优化点：

1. 使用多阶段构建，最终镜像只包含运行时环境
2. 先单独复制pom.xml下载依赖，利用Docker缓存
3. 使用轻量级的JRE基础镜像而非JDK
4. 使用非root用户运行增强安全性

3.2 构建并运行镜像

构建镜像命令：

docker build -t flowable-app:1.0 .

运行容器：

docker run -d -p 8080:8080 \
  -e DB_HOST=mysql \
  -e DB_USER=root \
  -e DB_PASSWORD=123456 \
  --name flowable-app \
  flowable-app:1.0

4. 多容器通信配置

4.1 创建MySQL容器

首先拉取MySQL官方镜像：

docker pull mysql:8.0

运行MySQL容器时需要注意字符集和时区设置：

docker run -d --name mysql \
  -e MYSQL_ROOT_PASSWORD=123456 \
  -e MYSQL_DATABASE=flowable \
  -e TZ=Asia/Shanghai \
  -v mysql_data:/var/lib/mysql \
  mysql:8.0 \
  --character-set-server=utf8mb4 \
  --collation-server=utf8mb4_unicode_ci

4.2 容器网络配置

创建自定义网络让容器可以通过服务名通信：

docker network create flowable-net

将两个容器都加入这个网络：

docker network connect flowable-net mysql
docker network connect flowable-net flowable-app

4.3 使用Docker Compose编排

更推荐使用docker-compose.yml一键管理所有服务：

version: '3.8'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: 123456
      MYSQL_DATABASE: flowable
      TZ: Asia/Shanghai
    volumes:
      - mysql_data:/var/lib/mysql
    command: 
      --character-set-server=utf8mb4
      --collation-server=utf8mb4_unicode_ci
    networks:
      - flowable-net
  
  flowable-app:
    build: .
    environment:
      DB_HOST: mysql
      DB_USER: root
      DB_PASSWORD: 123456
    ports:
      - "8080:8080"
    depends_on:
      mysql:
        condition: service_healthy
    networks:
      - flowable-net

volumes:
  mysql_data:

networks:
  flowable-net:
    driver: bridge

启动命令：

docker-compose up -d

5. 镜像优化与生产实践

5.1 镜像瘦身技巧

原始镜像大小约500MB，通过以下优化可以缩减到150MB左右：

1. 使用JLink创建自定义JRE：

RUN jlink --add-modules java.base,java.logging,java.management \
           --strip-debug \
           --no-man-pages \
           --no-header-files \
           --compress=2 \
           --output /opt/jre-minimal

2. 使用Alpine基础镜像：

FROM alpine:3.16
COPY --from=builder /opt/jre-minimal /opt/jre-minimal
ENV PATH="/opt/jre-minimal/bin:${PATH}"

3. 移除不必要的依赖和文件

5.2 健康检查配置

在Dockerfile中添加健康检查指令：

HEALTHCHECK --interval=30s --timeout=3s \
  CMD curl -f http://localhost:8080/actuator/health || exit 1

5.3 日志管理最佳实践

1. 使用json-file日志驱动
2. 配置日志轮转
3. 将日志输出到stdout/stderr

RUN ln -sf /dev/stdout /app/logs/application.log \
 && ln -sf /dev/stderr /app/logs/error.log

6. 常见问题排查

6.1 数据库连接问题

如果应用启动时报数据库连接错误，可以：

1. 检查MySQL容器是否正常运行：

docker logs mysql

2. 进入容器测试连接：

docker exec -it mysql mysql -uroot -p123456

6.2 Flowable表未自动创建

检查配置：

flowable:
  database-schema-update: true

如果仍然不生效，可以手动初始化：

CREATE DATABASE flowable CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

6.3 容器间通信失败

检查网络配置：

docker network inspect flowable-net

测试容器间连通性：

docker exec -it flowable-app ping mysql

7. 进阶配置与优化

7.1 使用Redis缓存流程定义

在application.yml中添加配置：

flowable:
  enable-safe-bpmn-xml: true
  process-definition-cache:
    enabled: true
    max-size: 100

7.2 配置异步执行器

flowable:
  async-executor-activate: true
  async-executor:
    core-pool-size: 10
    max-pool-size: 50
    queue-size: 100

7.3 监控端点配置

启用Flowable的监控端点：

management:
  endpoints:
    web:
      exposure:
        include: health,info,flowable

访问地址：

http://localhost:8080/actuator/flowable

8. 实际项目经验分享

在电商订单审核系统中，我们使用这套方案实现了：

• 日均处理10万+订单审核流程
• 平均响应时间<200ms
• 支持50+并行流程定义

关键优化点包括：

1. 使用JProfiler分析内存泄漏
2. 配置合理的连接池参数
3. 对高频流程启用缓存
4. 使用Flyway管理数据库变更

遇到的一个典型问题是流程实例堆积，解决方案是：

@Configuration
public class FlowableConfig {
    @Bean
    public SpringProcessEngineConfiguration processEngineConfiguration(
            DataSource dataSource, PlatformTransactionManager transactionManager) {
        SpringProcessEngineConfiguration config = new SpringProcessEngineConfiguration();
        config.setDataSource(dataSource);
        config.setTransactionManager(transactionManager);
        config.setAsyncExecutorNumberOfRetries(5);
        config.setAsyncExecutorMaxAsyncJobsDuePerAcquisition(100);
        return config;
    }
}