MyBatis-Plus与Docker集成开发实践指南-拓冰建站

1. 项目背景与技术选型

这个标题看起来像是某个技术学习或项目开发日志的第四天记录，主要涉及MyBatis-Plus和Docker两个技术栈的结合使用。在实际开发中，这种组合非常常见——MyBatis-Plus作为ORM框架简化数据库操作，Docker则用于容器化部署，二者结合可以极大提升开发效率和部署便捷性。

我曾在多个电商和ERP系统中采用这种技术组合。以最近的一个供应链管理系统为例，使用MyBatis-Plus后，基础CRUD代码量减少了约70%，而Docker化部署使环境配置时间从原来的半天缩短到10分钟。这种效率提升对于需要快速迭代的项目尤为重要。

2. MyBatis-Plus核心功能解析

2.1 基础CRUD的简化

MyBatis-Plus最显著的特点就是几乎零编码实现基础CRUD。通过继承BaseMapper接口，你的DAO层立即获得18个常用方法：

public interface UserMapper extends BaseMapper<User> { // 无需任何实现 }

这样就能直接使用：

userMapper.selectById(1); userMapper.insert(newUser); userMapper.updateById(updatedUser);

注意：虽然方便，但建议对复杂查询仍使用原生MyBatis的XML或注解方式，保持代码可读性。

2.2 条件构造器的强大功能

Wrapper是MyBatis-Plus的精华所在，它允许你用Java代码构建SQL条件：

QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.like("name", "张") .between("age", 20, 30) .orderByDesc("create_time"); List<User> users = userMapper.selectList(wrapper);

实际项目中，我通常会封装一个WrapperBuilder工具类，处理一些公共条件如：

租户ID过滤
逻辑删除过滤
数据权限控制

2.3 代码生成器的正确使用

mybatis-plus-generator可以快速生成Entity、Mapper、Service等代码。但有几个实用技巧：

自定义模板：修改resources/templates下的.ftl文件调整生成风格
策略配置：使用StrategyConfig控制生成规则
自定义注入：通过InjectionConfig添加自定义属性

// 典型配置示例 AutoGenerator generator = new AutoGenerator(); generator.setGlobalConfig(globalConfig); generator.setDataSource(dataSourceConfig); generator.setPackageInfo(packageConfig); generator.setStrategy(strategyConfig); generator.setTemplate(templateConfig); generator.execute();

3. Docker集成实践

3.1 基础镜像选择

对于Java应用，推荐使用官方openjdk镜像而非自定义镜像。根据项目需求选择合适版本：

FROM openjdk:11-jre-slim # 生产环境推荐 # FROM openjdk:11-jdk # 开发环境需要编译时使用

经验：slim版本比alpine更稳定，且只比alpine大20MB左右，但避免了glibc兼容性问题。

3.2 多阶段构建优化

使用多阶段构建可以显著减小最终镜像大小：

# 第一阶段：构建 FROM maven:3.6-jdk-11 as builder WORKDIR /app COPY pom.xml . RUN mvn dependency:go-offline COPY src/ /app/src/ RUN mvn package -DskipTests # 第二阶段：运行 FROM openjdk:11-jre-slim COPY --from=builder /app/target/*.jar /app/app.jar ENTRYPOINT ["java","-jar","/app/app.jar"]

这种构建方式可以将镜像从500MB+降到150MB左右。

3.3 容器化MyBatis-Plus应用的特殊配置

在容器中运行MyBatis-Plus应用需要注意：

数据库连接配置应使用环境变量：

spring: datasource: url: ${DB_URL} username: ${DB_USER} password: ${DB_PASSWORD}

时区问题：

ENV TZ=Asia/Shanghai RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

健康检查：

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

4. 开发环境优化

4.1 本地Docker开发流程

推荐使用docker-compose管理开发环境：

version: '3' services: app: build: . ports: - "8080:8080" environment: - DB_URL=jdbc:mysql://db:3306/demo - DB_USER=root - DB_PASSWORD=123456 depends_on: - db volumes: - ./:/app # 开发时挂载代码目录 db: image: mysql:5.7 environment: - MYSQL_ROOT_PASSWORD=123456 - MYSQL_DATABASE=demo ports: - "3306:3306"

关键技巧：

使用volumes实现代码热更新
合理配置depends_on和healthcheck确保启动顺序
开发和生产使用不同的compose文件

4.2 测试数据准备

结合MyBatis-Plus和Docker可以方便地初始化测试数据：

在src/test/resources下准备SQL文件
使用TestContainer运行集成测试：

@Testcontainers class UserMapperTest { @Container static MySQLContainer<?> mysql = new MySQLContainer<>("mysql:5.7"); @BeforeAll static void setup() { // 初始化数据源 String jdbcUrl = mysql.getJdbcUrl(); // ... 创建DataSource并执行初始化SQL } }

5. 生产部署实践

5.1 镜像优化进阶

除了多阶段构建，还可以：

使用JLink创建自定义JRE（Java 9+）
启用分层构建利用Docker缓存
使用jemalloc优化内存分配

# 使用分层构建 FROM openjdk:11-jre-slim as builder WORKDIR /app COPY target/*.jar app.jar RUN java -Djarmode=layertools -jar app.jar extract FROM openjdk:11-jre-slim COPY --from=builder /app/dependencies/ ./ COPY --from=builder /app/snapshot-dependencies/ ./ COPY --from=builder /app/application/ ./ ENTRYPOINT ["java", "org.springframework.boot.loader.JarLauncher"]

5.2 监控与日志

生产环境需要完善的监控：

集成Prometheus指标

<dependency> <groupId>io.micrometer</groupId> <artifactId>micrometer-registry-prometheus</artifactId> </dependency>

日志收集配置

# 使用json日志格式便于ELK处理 ENV LOGGING_LEVEL_ROOT=info ENV LOGGING_LEVEL_ORG_SPRINGFRAMEWORK_WEB=warn ENV LOGGING_PATTERN_CONSOLE="{\"time\":\"%d{yyyy-MM-dd HH:mm:ss.SSS}\",\"level\":\"%5p\",\"pid\":\"${PID:-}\",\"thread\":\"%t\",\"logger\":\"%40.40logger{39}\",\"msg\":\"%m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}\"}"

6. 常见问题排查

6.1 MyBatis-Plus典型问题

SQL注入风险：避免直接拼接用户输入到Wrapper条件中
- 错误示例：wrapper.apply("date_format(create_time,'%Y-%m-%d') = '"+date+"'")
- 正确做法：使用参数化wrapper.apply("date_format(create_time,'%Y-%m-%d') = {0}", date)

分页插件冲突：同时使用多个分页插件会导致异常

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); return interceptor; } }

6.2 Docker部署问题

时区不一致：容器内时间与宿主机不同
- 解决方案：前面提到的TZ环境变量设置
- 验证：在Dockerfile中添加RUN date命令验证

内存限制：JVM未正确识别容器内存限制

解决方案：使用JVM参数

ENV JAVA_OPTS="-XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0" ENTRYPOINT exec java $JAVA_OPTS -jar /app.jar

数据库连接失败：应用启动时数据库未就绪

解决方案：使用wait-for-it.sh脚本

COPY wait-for-it.sh /wait-for-it.sh RUN chmod +x /wait-for-it.sh ENTRYPOINT ["/wait-for-it.sh", "db:3306", "--", "java", "-jar", "/app.jar"]

7. 性能优化技巧

7.1 MyBatis-Plus性能优化

批量操作：使用Service的saveBatch方法

userService.saveBatch(users, 1000); // 每批1000条

逻辑删除优化：默认逻辑删除会全表扫描
- 解决方案：添加索引@TableLogic字段
- 或者使用物理删除+备份表方案

SQL打印优化：生产环境关闭SQL打印

mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.nologging.NoLoggingImpl

7.2 Docker性能优化

构建缓存利用：合理排序Dockerfile指令
- 将变化频率低的指令放前面
- 例如先COPY pom.xml再COPY src

资源限制：合理配置容器资源

deploy: resources: limits: cpus: '2' memory: 2G

JVM调优：根据容器环境调整JVM参数

-XX:InitialRAMPercentage=50.0 -XX:MaxRAMPercentage=80.0 -XX:+UseG1GC

8. 安全最佳实践

8.1 MyBatis-Plus安全配置

防止全表更新：配置阻断全表操作

@Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new BlockAttackInnerInterceptor()); return interceptor; }

敏感字段加密：使用@FieldEncrypt注解

@FieldEncrypt(algorithm = Algorithm.PBEWithMD5AndDES) private String password;

8.2 Docker安全实践

非root用户运行：

RUN addgroup -S appgroup && adduser -S appuser -G appgroup USER appuser

镜像扫描：使用trivy扫描漏洞

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \ aquasec/trivy image your-image:tag

网络隔离：使用自定义网络

networks: app-network: driver: bridge internal: true

9. 扩展与进阶

9.1 MyBatis-Plus插件开发

自定义插件示例（实现数据权限过滤）：

@Intercepts({ @Signature(type= Executor.class, method="query", args={MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class}) }) public class DataPermissionInterceptor implements Interceptor { @Override public Object intercept(Invocation invocation) throws Throwable { // 解析当前用户权限 // 修改SQL添加条件 return invocation.proceed(); } }

9.2 Kubernetes集成

将Docker化的MyBatis-Plus应用部署到K8s：

创建Deployment

apiVersion: apps/v1 kind: Deployment metadata: name: myapp spec: replicas: 3 selector: matchLabels: app: myapp template: spec: containers: - name: app image: myapp:1.0 envFrom: - configMapRef: name: app-config resources: limits: memory: "1Gi" cpu: "500m"

配置ConfigMap管理环境变量

apiVersion: v1 kind: ConfigMap metadata: name: app-config data: DB_URL: "jdbc:mysql://mysql-service:3306/demo" SPRING_PROFILES_ACTIVE: "prod"

10. 项目结构建议

一个典型的MyBatis-Plus+Docker项目结构：

src/ ├── main/ │ ├── java/ │ │ └── com/example/ │ │ ├── config/ # 配置类 │ │ ├── controller/ # 控制层 │ │ ├── entity/ # 实体类 │ │ ├── mapper/ # Mapper接口 │ │ ├── service/ # 业务层 │ │ └── Application.java │ ├── resources/ │ │ ├── application.yml # 主配置 │ │ └── application-dev.yml # 开发配置 ├── test/ # 测试代码 docker/ ├── Dockerfile # 生产镜像构建 ├── Dockerfile.dev # 开发镜像构建 ├── docker-compose.yml # 生产配置 └── docker-compose.dev.yml # 开发配置

这种结构分离了不同环境的配置，便于维护和扩展。在实际项目中，我通常会添加一个deploy目录存放Kubernetes或Swarm的部署描述文件。