作为 Java 开发者，你是否已经厌倦了 Spring Boot 容器化过程中的各种复杂配置和坑点？想要尝试更轻量、更高效的框架？那么 Solon 绝对值得你关注。今天我就带你实战 Solon 框架与 Docker 的集成，从环境准备到最终部署，全程避坑指南，让你 30 分钟内轻松搞定！
为什么选择 Solon + Docker？
在微服务架构盛行之下，应用容器化已成为标配。但传统的 Spring Boot 虽然功能强大，但在启动速度、内存占用和容器化体验上仍有优化空间。听一个老同事说，他们公司经常有1GB大小的 Spring Boot Jar 包。
Solon 的优势：
- 启动速度极快：Solon 应用的启动时间通常是 Spring Boot 的
1/10到1/5 - 内存占用更小：基础镜像体积更小，运行时内存消耗更低。通常只有 Spring Boot 的
1/10到1/2 - 配置更简洁：Docker 集成配置简单明了，减少踩坑概率
- 原生支持容器化：从设计之初就考虑了云原生场景
环境准备：三步搞定基础配置
在开始之前，确保你的本地环境满足以下要求：
1. 确认环境版本
- JDK 版本：Solon 支持 JDK 8+，推荐使用 JDK 11 或 17 以获得更好的容器化支持
- Docker 版本：Docker 20.10+，推荐使用 Docker Desktop 4.0+
- Maven 版本：Maven 3.6+，确保插件兼容性
快速验证命令：
java -version docker -v mvn -v 2. 创建 Solon 项目
如果你还没有 Solon 项目，可以通过网页版生成器快速创建：
https://solon.noear.org/start/ 核心步骤：Docker 集成实战
1. 配置 Maven 插件
在 pom.xml 中添加 Docker 打包插件。这里我们使用经过验证的 spotify 插件：
<plugin> <groupId>com.spotify</groupId> <artifactId>docker-maven-plugin</artifactId> <version>1.2.2</version> <configuration> <!-- 镜像名称配置 --> <imageName>solon-demo</imageName> <imageTags> <imageTag>${project.version}</imageTag> <imageTag>latest</imageTag> </imageTags> <!-- 使用推荐的基础镜像 --> <baseImage>adoptopenjdk/openjdk11:jre-11.0.11_9-alpine</baseImage> <!-- 容器启动命令 --> <entryPoint>["java", "-jar", "/${project.build.finalName}.jar", "--server.port=8080", "--drift=1"]</entryPoint> <resources> <resource> <targetPath>/</targetPath> <directory>${project.build.directory}</directory> <include>${project.build.finalName}.jar</include> </resource> </resources> </configuration> </plugin> 避坑提示：
- 使用 alpine 版本的 JDK 镜像可以显著减小镜像体积（如果不兼容，可以再换个别的）
- entryPoint 必须使用数组格式，确保参数传递正确
- 确保 finalName 与打包后的 jar 包名称一致
- 加上
--drift=1表示当前环境ip会漂移的（如果有注册服务，当下线时要求不作健康检测）。这是 solon 对云原生的一种优化。
2.备选方案：使用 Dockerfile
如果你更喜欢传统的 Dockerfile 方式，可以在项目根目录创建 Dockerfile：
# 使用轻量级基础镜像 FROM adoptopenjdk/openjdk11:jre-11.0.11_9-alpine # 设置工作目录 WORKDIR /app # 复制 jar 文件 COPY target/solon-demo-1.0.0.jar app.jar # 暴露端口（根据你的应用配置调整） EXPOSE 8080 # 启动应用 ENTRYPOINT ["java", "-jar", "app.jar", "--server.port=8080", "--drift=1"] 然后在 pom.xml 中配置插件使用 Dockerfile：
<plugin> <groupId>com.spotify</groupId> <artifactId>docker-maven-plugin</artifactId> <version>1.2.2</version> <configuration> <imageName>solon-demo</imageName> <dockerDirectory>${project.basedir}</dockerDirectory> <resources> <resource> <targetPath>/</targetPath> <directory>${project.build.directory}</directory> <include>${project.build.finalName}.jar</include> </resource> </resources> </configuration> </plugin> 3. 构建和运行
构建 Docker 镜像：
# 先打包应用 mvn clean package # 构建 Docker 镜像 mvn docker:build 构建成功后，验证镜像：
docker images | grep solon-demo 运行容器：
# 第一次运行 docker run -d -p 8080:8080 --name solon-app solon-demo # 查看运行状态 docker ps | grep solon-app # 查看日志 docker logs solon-app 容器管理命令：
# 停止容器 docker stop solon-app # 重启容器 docker restart solon-app # 删除容器 docker rm solon-app 进阶技巧：优化和部署
1. 镜像标签管理和推送
为镜像打标签并推送到镜像仓库：
# 打标签 docker tag solon-demo:latest your-repo/solon-demo:1.0.0 docker tag solon-demo:latest your-repo/solon-demo:latest # 推送到仓库 docker push your-repo/solon-demo:1.0.0 docker push your-repo/solon-demo:latest 2. 生产环境配置
对于生产环境，建议添加健康检查和资源限制：
docker run -d -p 8080:8080 --name solon-app --memory=512m --cpus=1.0 solon-demo 常见问题排查
1. 容器启动后立即退出
- 检查应用启动日志：docker logs solon-app
- 确认 jar 包路径正确
- 验证端口是否被占用
2. 应用无法访问
- 检查端口映射：docker ps 确认端口映射关系
- 验证防火墙设置
- 检查应用监听的地址（确保是 0.0.0.0 而不是 127.0.0.1）
3. 镜像体积过大
- 使用 alpine 版本的基础镜像
- 多阶段构建去除构建依赖
- 使用 JRE 而不是完整的 JDK
总结
Solon 与 Docker 的集成相比传统框架更加轻量简洁，主要优势体现在：
- 配置简单：Maven 插件配置直观，减少出错概率
- 镜像小巧：基础镜像选择灵活，最终镜像体积更小
- 启动快速：容器启动速度更快，适合快速扩缩容
通过本文的实战指南，你应该能够在 30 分钟内完成 Solon 应用的 Docker 化。赶紧拿起你的 Solon 项目实践一下吧！如果在实践中遇到任何问题，欢迎在评论区交流讨论。
