# spring-boot-demo

**Repository Path**: netbuffer/spring-boot-demo

## Basic Information

- **Project Name**: spring-boot-demo
- **Description**: spring-boot 相关技术测试
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-06-06
- **Last Updated**: 2026-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, Spring, SpringBoot, SpringCloud, Spring-MVC

## README

# spring-boot-demo

![](https://img.shields.io/static/v1?label=java&message=1.8&color=blue)
![](https://img.shields.io/static/v1?label=spring-boot&message=2.7.18&color=blue)
![](https://img.shields.io/static/v1?label=spring-restdocs&message=2.0.4.RELEASE&color=blue)
![](https://img.shields.io/static/v1?label=junit&message=4.13.2&color=black)
![](https://img.shields.io/static/v1?label=hibernate-validator&message=6.2.5.Final&color=blue)

use spring-boot 2.x demo project

* https://shields.io/
* [github source](https://github.com/netbuffer/spring-boot-demo)
* [gitee source](https://gitee.com/netbuffer/spring-boot-demo)
* /actuator/health
* [spring-boot-2.7.18-reference](https://docs.spring.io/spring-boot/docs/2.7.18/reference/htmlsingle/)
* [@ControllerAdvice](https://docs.spring.io/spring-framework/docs/5.3.6/reference/html/web.html#mvc-ann-controller-advice)
* [Exceptions Process](https://docs.spring.io/spring-framework/docs/5.3.6/reference/html/web.html#mvc-ann-exceptionhandler)
* [ResponseEntityExceptionHandler](https://docs.spring.io/spring-framework/docs/5.3.6/javadoc-api/org/springframework/web/servlet/mvc/method/annotation/ResponseEntityExceptionHandler.html)
* [requestmapping](https://docs.spring.io/spring-framework/docs/5.3.6/reference/html/web.html#mvc-ann-requestmapping-registration)
* [mvc-sse](https://docs.spring.io/spring-framework/docs/5.3.6/reference/html/web.html#mvc-ann-async-sse)
* [hibernate_validator_reference](https://docs.jboss.org/hibernate/validator/6.2/reference/en-US/pdf/hibernate_validator_reference.pdf#validator-gettingstarted)
* https://docs.docker.com/compose/compose-file/compose-file-v3/#build
* https://hub.docker.com/_/openjdk

### server.servlet.session.timeout

```html
ns for nanoseconds
us for microseconds
ms for milliseconds
s for seconds
m for minutes
h for hours
d for days
```

### mvn build test

> `mvn -Dmvn-arg=your param -DskipTests clean package -P test`
> -Dparam,-Pyour profile

### maven-help-plugin use

* `mvn help:system` Displays a list of the platform details like system properties and environment variables
* `mvn help:help` Display help information on maven-help-plugin.Call mvn help:help -Ddetail=true -Dgoal=<goal-name> to display parameter details

### branch

* javamelody
* spring-restdocs
* templating-maven-plugin
* thymeleaf
* logback

### docker镜像制作

#### 自动构建（推荐）

推送代码到 `master` / `main` 分支或创建 `v*` 标签时，GitHub Actions 会自动完成编译、打包并发布镜像。

镜像**同时发布在 GitHub Container Registry 和 Docker Hub**，多架构支持 `linux/amd64` 与 `linux/arm64`：

```bash
# GitHub Container Registry（匿名可拉取）
docker pull ghcr.io/netbuffer/spring-boot-demo:1.0

# Docker Hub
docker pull javawiki/spring-boot-demo:1.0
```

手动触发一次 Release：

```bash
git tag v1.0.1 && git push origin v1.0.1
```

#### 构建

1. 先通过maven打包到target目录下
2. 执行构建指令：`cd target;docker build -f ../Dockerfile -t netbuffer/spring-boot-demo:1.0 ../` (`docker build -t netbuffer/spring-boot-demo:1.0 .`)

#### 运行

* docker run --rm -it -p 9100:9100 netbuffer/spring-boot-demo:1.0
* docker-compose up (使用docker-compose启动服务)

#### 发布到DockerHub

> 需要注册DockerHub身份，再docker login登录对应的Registry

1. docker images 找到镜像ID
2. docker tag 镜像ID 你的DockerHub账户名/spring-boot-demo:1.0 打tag
3. docker push 你的DockerHub账户名/spring-boot-demo:1.0 推送到远程

#### 远程镜像

> 已发布到DockerHub，可以直接运行以下指令测试
> https://hub.docker.com/r/javawiki/spring-boot-demo

* docker pull javawiki/spring-boot-demo:1.0          拉取远程镜像
* docker run -it --rm javawiki/spring-boot-demo:1.0  运行远程镜像

### articles

* [spring-boot中统一修改http响应体内容的方法](https://www.toutiao.com/i7014375995448820231)
* [spring-boot中异常的处理](https://www.toutiao.com/i7014369292791579148)
* [关于spring-boot中logback日志配置引用spring环境变量的使用方式](https://www.toutiao.com/i7014368145578230304)
* [spring-boot生成打包信息](https://www.toutiao.com/i7013891369404351014)
* [spring-boot生成git版本库信息](https://www.toutiao.com/i7013890854121226789)
* [Spring Boot动态注册/删除http资源路径的方法](https://www.toutiao.com/i7014752212727431694)
* [获取SpringBoot工程运行时的操作系统进程ID方法](https://www.toutiao.com/i7015456367477522977)
* [SpringBoot使用基于json格式的配置方法](https://www.toutiao.com/i7016209186543469069)
* [怎么查看SpringBoot工程中每个过滤器的执行顺序](https://www.toutiao.com/i7016666337527382532)
* [Spring中出现NoUniqueBeanDefinitionException的解决方法](https://www.toutiao.com/i7018897444583113247)

### CI/CD 配置

#### 工作流

`.github/workflows/build.yml` 定义 4 个 Job：

| Job | 触发条件 | 职责 |
|-----|----------|------|
| `build` | push (master/main/v\*) + PR | Dragonwell JDK 8 编译，上传 `target/spring-boot-demo.jar` 为 artifact（保留 30 天） |
| `release` | tag `v*` | 由 artifact 创建 GitHub Release，自动生成 release notes |
| `docker-ghcr` | tag `v*` | 多架构（amd64 + arm64）构建并推送到 `ghcr.io/netbuffer/spring-boot-demo`，打 `:<VERSION>` 与 `:latest` |
| `docker-hub` | tag `v*` | 多架构构建并推送到 `javawiki/spring-boot-demo`，打 `:<VERSION>` 与 `:latest` |

#### 仓库 Secrets

在仓库 **Settings → Secrets and variables → Actions** 中配置：

| Secret | 必填 | 说明 |
|--------|:----:|------|
| `DOCKERHUB_USERNAME` | ✓ | Docker Hub 用户名（当前为 `javawiki`） |
| `DOCKERHUB_TOKEN` | ✓ | Docker Hub Access Token，从 [hub.docker.com/settings/security](https://hub.docker.com/settings/security) 生成，需 `Read & Write` 权限 |
| `GITHUB_TOKEN` | - | GitHub Actions 自动注入，**无需手动创建**，权限由 workflow 的 `permissions: packages: write` 决定 |

#### ghcr.io 可见性

第一次自动推送后，包默认是 **private**。前往仓库 **Settings → Packages → spring-boot-demo → Package settings → Danger Zone → Change visibility** 改为 **Public**。

#### 本地调试 workflow

可以用 [act](https://github.com/nektos/act)（本机需 Docker）模拟运行 `build` Job：

```bash
act push -j build
```

注意：`act` 无法完整模拟 `docker-ghcr` / `docker-hub` Job 的镜像推送。