deepaksorthiya/spring-boot-3-openapi-3
deepaksorthiya
该镜像提供基于Spring Boot 3和OpenAPI 3的RESTful服务开发与部署环境，支持API文档自动生成、测试及容器化部署。
下载次数: 0状态：社区镜像维护者：deepaksorthiya仓库类型：镜像最近更新：1 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Spring Boot 3 OpenAPI 3 镜像文档
镜像概述
本镜像基于Spring Boot 3和OpenAPI 3构建，旨在提供快速开发RESTful服务的环境，支持自动生成Swagger UI格式的API文档，并可直接通过Docker容器化部署。
核心功能
- 集成Spring Boot 3框架，简化RESTful接口开发流程
- 支持OpenAPI 3规范，自动生成可视化API文档（Swagger UI）
- 提供完整的Maven构建、测试与容器化流程
- 支持端口映射与容器化运行，便于快速部署
使用场景
- 开发RESTful API服务并自动生成文档
- 学习Spring Boot 3与OpenAPI 3的集成实践
- 快速搭建API测试与展示平台
配置说明
环境要求
- Git 2.51+
- Spring Boot 3.5.9
- Maven 3.9+
- Java 25
- Docker Desktop 4.53+（用于容器化操作）
部署步骤
1. 克隆仓库
bashgit clone https://github.com/deepaksorthiya/spring-boot-3-openapi-3.git cd spring-boot-3-openapi-3
2. 构建项目
bash./mvnw clean package
3. 本地运行项目
bash./mvnw spring-boot:run
4. 运行测试用例
bash./mvnw clean verify
5. 构建Docker镜像（可选）
bash./mvnw clean spring-boot:build-image -DskipTests
6. Docker运行镜像（可选）
bashdocker run -p 8080:8080 --name spring-boot-3-openapi-3 docker.xuanyuan.run/deepaksorthiya/spring-boot-3-openapi-3:0.0.1-SNAPSHOT
测试端点
访问Swagger UI查看API文档：
http://localhost:8080/swagger-ui.html
可通过Postman测试接口，参考Postman集合：
https://www.postman.com/deepaksorthiya/workspace/public-ws/collection/***-ba448821-b03d-4d5d-b0a1-9b9d1fc6cac0?action=share&creator=***&active-environment=***-55c10ebe-548f-4c1b-a5ec-4d4ed996c033
参考文档
- https://maven.apache.org/guides/index.html
- https://docs.spring.io/spring-boot/maven-plugin
- https://docs.spring.io/spring-boot/current/maven-plugin/build-image.html
- https://docs.spring.io/spring-boot/current/reference/actuator/index.html
- https://docs.spring.io/spring-boot/current/reference/web/servlet.html
- https://docs.spring.io/spring-boot/current/reference/data/sql.html#data.sql.jpa-and-spring-data
学习指南
- https://spring.io/guides/gs/actuator-service/
- https://spring.io/guides/gs/rest-service/
- https://spring.io/guides/gs/serving-web-content/
- https://spring.io/guides/tutorials/rest/
- https://spring.io/guides/gs/accessing-data-jpa/
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 spring-boot-3-openapi-3 镜像标签
docker pull docker.xuanyuan.run/deepaksorthiya/spring-boot-3-openapi-3:<标签>
DockerHub 原生拉取命令
docker pull deepaksorthiya/spring-boot-3-openapi-3:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
