1. 项目概述从本地开发到生产部署的鸿沟十年前我刚入行时Java应用的部署还停留在把war包扔到Tomcat的webapps目录的原始阶段。如今在云原生时代Docker的出现让部署方式发生了革命性变化但很多团队依然面临一个经典困境为什么在本地能完美运行的应用一到生产环境就各种崩溃这个项目源于我们团队最近完成的一个电商促销系统技术栈是Spring Boot MySQL的标准组合。在开发阶段所有功能测试都顺利通过但首次部署到客户服务器时就遭遇了内存溢出、数据库连接池耗尽、配置文件加载失败等一系列问题。经过三天紧急排查和方案重构我们最终实现了一套可靠的Docker化部署方案将部署时间从原来的2小时缩短到15分钟且实现了环境一致性保障。2. 技术选型与架构设计2.1 基础技术栈组合我们选择了最经典的Java技术组合Spring Boot 2.7提供自动配置和starter依赖MySQL 8.0关系型数据库MyBatis-Plus数据访问层Redis缓存和分布式锁经验提示Spring Boot版本选择要考虑长期支持(LTS)版本我们放弃3.x而选择2.7是因为部分中间件还未完全适配Spring Boot 32.2 Docker化部署方案核心容器规划应用容器基于eclipse-temurin:17-jre的轻量级镜像MySQL容器官方镜像自定义配置Redis容器官方镜像Nginx容器负载均衡和静态资源# 应用Dockerfile示例 FROM eclipse-temurin:17-jre WORKDIR /app COPY target/*.jar app.jar COPY config/application-prod.yml ./config/ ENTRYPOINT [java,-Xmx512m,-jar,app.jar,--spring.config.locationfile:./config/application-prod.yml]3. 关键问题与解决方案3.1 环境差异问题问题现象本地开发使用H2数据库生产用MySQL配置文件路径不一致导致加载失败时区设置不一致导致时间显示错误解决方案统一配置管理# application.yml spring: profiles: active: activatedProperties config: import: optional:file:./config/override.yml # 生产环境单独配置 # config/override.yml spring: datasource: url: jdbc:mysql://${DB_HOST:localhost}:3306/db username: ${DB_USER} password: ${DB_PASSWORD}时区标准化ENV TZAsia/Shanghai RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime3.2 资源限制问题典型错误java.lang.OutOfMemoryError: Java heap space内存优化方案JVM参数调整java -Xms256m -Xmx512m -XX:MaxMetaspaceSize256m -jar app.jarDocker资源限制# docker-compose.yml services: app: deploy: resources: limits: memory: 768M3.3 数据库连接管理问题现象连接泄漏导致连接池耗尽生产环境连接数不足优化配置spring: datasource: hikari: maximum-pool-size: 20 connection-timeout: 30000 leak-detection-threshold: 600004. 自动化部署实践4.1 CI/CD流程设计graph LR A[代码提交] -- B(单元测试) B -- C{测试通过?} C --|是| D[构建Docker镜像] C --|否| E[通知开发者] D -- F[推送镜像到仓库] F -- G[生产环境拉取] G -- H[滚动更新]4.2 实际部署脚本#!/bin/bash # deploy.sh # 构建镜像 docker build -t registry.example.com/ecommerce:${BUILD_NUMBER} . # 推送镜像 docker push registry.example.com/ecommerce:${BUILD_NUMBER} # 生产环境更新 ssh prod-server docker pull registry.example.com/ecommerce:${BUILD_NUMBER} \ docker-compose stop app \ docker-compose up -d app5. 监控与日志方案5.1 健康检查配置# docker-compose.yml healthcheck: test: [CMD, curl, -f, http://localhost:8080/actuator/health] interval: 30s timeout: 5s retries: 35.2 日志收集方案日志卷挂载volumes: - ./logs:/app/logsLogback配置appender nameFILE classch.qos.logback.core.rolling.RollingFileAppender file${LOG_PATH}/app.log/file rollingPolicy classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy fileNamePattern${LOG_PATH}/app.%d{yyyy-MM-dd}.%i.log/fileNamePattern maxFileSize50MB/maxFileSize maxHistory30/maxHistory /rollingPolicy /appender6. 安全加固措施6.1 镜像安全使用最小化基础镜像定期扫描漏洞docker scan my-app-image6.2 网络隔离networks: backend: driver: bridge internal: true7. 性能优化技巧7.1 启动速度优化使用Spring Boot 2.4的懒初始化spring: main: lazy-initialization: true分层构建Docker镜像FROM eclipse-temurin:17-jdk as builder WORKDIR /app COPY . . RUN ./gradlew build FROM eclipse-temurin:17-jre COPY --frombuilder /app/build/libs/*.jar app.jar7.2 资源利用率提升合理设置JVM参数-XX:UseContainerSupport -XX:MaxRAMPercentage75.0容器垂直伸缩deploy: resources: limits: cpus: 2 memory: 1G8. 常见问题排查指南问题现象可能原因解决方案应用启动后立即退出内存不足检查docker stats和JVM内存设置数据库连接超时网络策略限制检查docker network和防火墙规则配置文件未生效挂载路径错误使用docker exec进入容器检查文件路径时区显示不正确容器时区未设置在Dockerfile中配置TZ环境变量9. 项目复盘与经验总结经过这次项目部署实践我们总结了以下几点关键经验环境一致性必须保证开发、测试、生产环境的完全一致Docker在这方面提供了完美解决方案资源配置生产环境需要根据实际负载进行压力测试不能简单沿用开发配置渐进式发布采用蓝绿部署或金丝雀发布策略避免全量更新带来的风险监控先行在应用上线前就要部署好监控系统而不是等问题发生后再补救这套部署方案目前已经在公司5个项目中成功实施平均部署时间缩短80%环境问题减少95%。对于Java开发者来说掌握Docker化部署已经成为必备技能而不仅仅是加分项。