Java 后端 / 知识点

Spring Boot 开发速查手册

手册条目

快速选择合适的 Java 版本、构建工具和项目依赖。

创建 Spring Boot 项目

用于从零生成一个可构建、可启动、可验证的 Spring Boot 服务。默认组合采用 Java 21、Maven Wrapper 和最小依赖集;已有系统受运行环境或第三方库限制时,再降到 Java 17。

版本与依赖选择

Spring Boot 4.1.x 至少需要 Java 17。新项目优先选 Java 21;团队已有 Maven 规范时选 Maven,只有确实需要复杂构建逻辑或 Kotlin DSL 时再选 Gradle。Spring MVC 项目使用 spring-boot-starter-webmvc,再按实际需要增加 Validation、Actuator 等能力。

选择项 建议
Spring Boot 绿地项目优先选择当前稳定的 4.1.x;已有 3.x 生态约束时保持兼容的 3.5.x
Java 默认 21;必须兼容旧运行环境时选 17
打包 服务端应用通常选 Jar
基础依赖 Web MVC、Validation、Actuator 按需选择
扩展依赖 数据库、安全、消息队列确认使用后再添加

不要一次勾选所有 Starter。多余依赖会引入额外自动配置,可能带来无用连接、默认安全配置或新的启动约束。

命令创建

通过 Spring Initializr 生成 Maven 项目,并固定 Java 与 Spring Boot 版本,便于团队复现。版本固定并不意味着永久不升级,后续应在统一依赖升级流程中更新。

bash
curl -fsSLG "https://start.spring.io/starter.zip" \
  --data-urlencode "type=maven-project" \
  --data-urlencode "language=java" \
  --data-urlencode "bootVersion=4.1.0" \
  --data-urlencode "javaVersion=21" \
  --data-urlencode "groupId=com.example" \
  --data-urlencode "artifactId=demo-service" \
  --data-urlencode "name=demo-service" \
  --data-urlencode "packageName=com.example.demo" \
  --data-urlencode "version=0.0.1-SNAPSHOT" \
  --data-urlencode "packaging=jar" \
  --data-urlencode "dependencies=webmvc,validation,actuator" \
  -o demo-service.zip

unzip -q demo-service.zip -d demo-service
cd demo-service
test -f pom.xml && test -f mvnw && echo "project generated: demo-service"

预期输出

text
project generated: demo-service

目录中应至少包含 pom.xml、mvnw、mvnw.cmd 和 src。若下载结果不是有效 ZIP,可执行 file demo-service.zip 检查,常见原因是版本参数无效、代理返回错误页或网络重定向。

构建与启动验证

使用项目自带的 Maven Wrapper 构建,再启动应用并检查 Actuator 健康端点。下面的轮询只用于本地验证,实际端口可能不同。

bash
./mvnw -q clean package
./mvnw -q spring-boot:run > app.log 2>&1 &
APP_PID=$!
READY=false

for i in {1..60}; do
  if curl -fsS "http://127.0.0.1:8080/actuator/health"; then
    echo
    READY=true
    break
  fi
  sleep 1
done

kill "$APP_PID"
test "$READY" = "true"

预期输出

json
{"status":"UP"}

若在 60 秒内没有返回,先查看 app.log。优先检查 JDK 版本、8080 端口占用、依赖下载失败,以及是否额外加入了数据库 Starter 却没有配置连接信息。

风险与边界

固定 bootVersion 可以保证脚本可复现,但会让项目停留在旧补丁版本;安全做法是由依赖升级任务统一修改,并配合完整测试。Spring Boot 主版本升级还可能带来 Spring Framework、Spring Cloud、监控 Agent 或第三方 Starter 的兼容性变化,因此上线前应检查对应兼容矩阵,而不是只看“能够编译”。

Windows 使用 mvnw.cmd,PowerShell 可用 Expand-Archive 解压。生产项目应提交 Maven Wrapper 文件,避免不同开发机因 Maven 版本不同产生构建差异。

目录与阅读设置

记录一个想法

Spring Boot 开发速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通