Spring Boot 应用脚手架

从一个空目录到可运行的 API

手动搭建 Spring Boot 项目并不复杂，但很琐碎：在 pom.xml 里逐个挑依赖版本，确认 groupId、artifactId 的命名，再按习惯创建 Controller、Service、Model 三层包结构，最后还要反复改配置直到启动不报错。这个过程每次新建项目都要重来一遍，而且很容易漏掉某些“应该有”的东西，比如统一的包命名规范或某个必要的 starter。

springbootBuildSkill 做的事情就是把这套流程固化下来。它提供一份位于 assets/springboot-template/ 的标准项目模板，以及一个初始化脚本，让你不再从零开始拼装。

模板里有什么

• 三层架构落地：Controller 层处理 HTTP 请求与参数校验，Service 层承载业务逻辑，Model 层定义数据实体。这个分层方式是 Spring 项目里最常见的做法，模板直接按此组织代码。
• 完整的用户管理 REST API：模板内置了 6 个接口端点，覆盖 GET、POST、PUT、DELETE 四种 HTTP 方法。包括问候接口 /api/hello，以及 /api/users 的增删改查，启动后可以直接验证。
• 清晰的扩展路径：想加新模块时，按照 model 下建实体、service 下加 @Service 类、controller 下加 @RestController 类的固定顺序操作即可。数据库支持可以通过修改 pom.xml 添加 mysql-connector-java 和 spring-boot-starter-data-jpa 来启用。

怎么用

最快的方式是直接运行初始化脚本，它会把模板复制到目标位置。如果脚本不可用，也可以手动操作：复制 assets/springboot-template/，然后改三个地方——pom.xml 里的 groupId 和 artifactId，包名（默认是 com.example.demo），以及 application.properties 中的端口和应用名。

验证启动很简单：访问 http://localhost:8080/api/hello，如果返回问候信息，说明项目已经跑通。

适用边界与注意点

这份模板的定位是 项目骨架，而不是开箱即用的生产系统。它没有集成 Spring Security、Spring Cloud 等重型组件，也没有引入数据库迁移工具。如果你需要的是微服务架构或复杂的鉴权流程，这个技能只能提供一个起点。

另外，模板里内置的用户管理 REST API 更像是一份参考实现，你大概率会替换掉它。扩展时注意遵循三层结构的约定，不要把所有逻辑都堆在 Controller 里。

环境要求

• JDK 17+：模板使用的 Spring Boot 版本依赖此最低要求
• Maven 3.6+：构建和启动都需要

详细的开发指南可以参考 references/springboot-dev-guide.md，里面包含环境配置、启动方式、常用注解和常见问题的解答。