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 BaseMapperUser { // 无需任何实现 }这样就能直接使用userMapper.selectById(1); userMapper.insert(newUser); userMapper.updateById(updatedUser);注意虽然方便但建议对复杂查询仍使用原生MyBatis的XML或注解方式保持代码可读性。2.2 条件构造器的强大功能Wrapper是MyBatis-Plus的精华所在它允许你用Java代码构建SQL条件QueryWrapperUser wrapper new QueryWrapper(); wrapper.like(name, 张) .between(age, 20, 30) .orderByDesc(create_time); ListUser 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 --frombuilder /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 TZAsia/Shanghai RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime echo $TZ /etc/timezone健康检查HEALTHCHECK --interval30s --timeout3s \ CMD curl -f http://localhost:8080/actuator/health || exit 14. 开发环境优化4.1 本地Docker开发流程推荐使用docker-compose管理开发环境version: 3 services: app: build: . ports: - 8080:8080 environment: - DB_URLjdbc:mysql://db:3306/demo - DB_USERroot - DB_PASSWORD123456 depends_on: - db volumes: - ./:/app # 开发时挂载代码目录 db: image: mysql:5.7 environment: - MYSQL_ROOT_PASSWORD123456 - MYSQL_DATABASEdemo 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创建自定义JREJava 9启用分层构建利用Docker缓存使用jemalloc优化内存分配# 使用分层构建 FROM openjdk:11-jre-slim as builder WORKDIR /app COPY target/*.jar app.jar RUN java -Djarmodelayertools -jar app.jar extract FROM openjdk:11-jre-slim COPY --frombuilder /app/dependencies/ ./ COPY --frombuilder /app/snapshot-dependencies/ ./ COPY --frombuilder /app/application/ ./ ENTRYPOINT [java, org.springframework.boot.loader.JarLauncher]5.2 监控与日志生产环境需要完善的监控集成Prometheus指标dependency groupIdio.micrometer/groupId artifactIdmicrometer-registry-prometheus/artifactId /dependency日志收集配置# 使用json日志格式便于ELK处理 ENV LOGGING_LEVEL_ROOTinfo ENV LOGGING_LEVEL_ORG_SPRINGFRAMEWORK_WEBwarn 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:MaxRAMPercentage75.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.NoLoggingImpl7.2 Docker性能优化构建缓存利用合理排序Dockerfile指令将变化频率低的指令放前面例如先COPY pom.xml再COPY src资源限制合理配置容器资源deploy: resources: limits: cpus: 2 memory: 2GJVM调优根据容器环境调整JVM参数-XX:InitialRAMPercentage50.0 -XX:MaxRAMPercentage80.0 -XX:UseG1GC8. 安全最佳实践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: true9. 扩展与进阶9.1 MyBatis-Plus插件开发自定义插件示例实现数据权限过滤Intercepts({ Signature(type Executor.class, methodquery, 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创建DeploymentapiVersion: 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: prod10. 项目结构建议一个典型的MyBatis-PlusDocker项目结构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的部署描述文件。