Spring Boot 项目怎么起步：Initializr、配置读取、MyBatis 和脚手架边界

3次阅读

Spring Boot 项目最容易走向两个极端：一种是只用 Initializr 点几下就开始写业务，后面配置、数据库、日志、异常处理全靠临时补；另一种是刚起步就搬一个巨大的脚手架，里面权限、代码生成、网关、监控、前端后台一股脑全上，最后删不干净也改不动。

更稳的方式是先把“最小可运行骨架”和“后续脚手架边界”分开。项目早期先把依赖、配置、数据库访问和基础约定立住，等重复问题真的出现，再抽成脚手架或公共模板。

新项目可以先从 Spring Initializr 开始，而不是从别人完整业务仓库里复制。

常见基础选择：

JDK 17；
Spring Boot 3；
Maven 或 Gradle，个人项目里 Maven 更直观；
Spring Web；
Validation；
MySQL Driver 或对应数据库驱动；
MyBatis 或 MyBatis-Plus，按项目习惯选择；
Lombok 如果团队接受，可以加入，但不要让实体语义完全依赖注解魔法。

初始化完成后，建议先做一次干净提交。这个提交只包含官方生成骨架和最小配置，不掺业务代码。后面如果项目结构改乱了，还能很清楚地看到自己到底改过哪些地方。

项目创建后，不要急着连数据库。先跑一个最小 HTTP 接口，确认启动、端口、日志和返回结构都正常。

比如：

@RestController
class HealthController {
    @GetMapping("/health")
    public Map<String, String> health() {
        return Map.of("status", "ok");
    }
}

这一步看似简单，但能提前确认：

JDK 版本是否正确；
依赖是否能下载；
本地端口是否冲突；
应用能否正常启动；
IDE 和命令行运行是否一致。

等最小接口稳定，再引入数据库、缓存、异步任务等组件，排障会简单很多。

Spring Boot 配置很灵活，但灵活也容易乱。

建议一开始就定下几个约定：

公共默认配置放 application.yml；
本地真实密码、私有路径和账号放本机私有配置；
不把真实密钥写进源码默认值；
复杂配置使用 @ConfigurationProperties 映射成对象；
对外可调参数写清单位和语义。

例如：

@ConfigurationProperties(prefix = "app.task")
public class TaskProperties {
    private int workerCount;
    private Duration timeout;
}

这种方式比到处 @Value("${xxx}") 更适合长期维护。配置集中成对象后，字段可以加校验、说明和默认值，也方便测试。

读取 resources 文件时也要小心。开发环境里通过文件路径能读到，不代表打成 JAR 后还能读到。更稳的方式是通过 ClassPathResource、ResourceLoader 或 Spring 注入资源，而不是依赖本机相对路径。

如果项目使用 MyBatis，可以先手写一组最小 Mapper，确认连接、SQL、事务和返回结构都跑通，再考虑代码生成。

起步阶段至少确认：

数据源配置是否清楚；
表字段和 Java 字段命名规则是否一致；
时间字段的时区语义是否明确；
SQL 是否有必要注释；
Mapper XML 或注解风格是否统一；
事务边界放在 Service 层，而不是 Controller 里临时拼。

mybatis-generator 或类似代码生成工具适合在表较多时节省重复劳动，但不要一开始就把生成代码当成架构。生成器应该服务于项目约定，而不是让项目被生成器目录结构牵着走。

一个实用原则是：生成模型和基础 CRUD 可以自动化，核心业务查询、复杂关联和状态流转逻辑应该人工审查。

早期项目可以轻，但不要每个接口自己随手返回。

建议尽早统一三件事：

请求入参校验；
统一响应结构；
全局异常处理。

入参用 Bean Validation：

public record CreateUserRequest(
    @NotBlank String name,
    @Email String email
) {
}

Controller 里接收：

@PostMapping("/users/create")
public ApiResponse<Long> create(@Valid @RequestBody CreateUserRequest request) {
    return ApiResponse.ok(userService.create(request));
}

全局异常处理再把校验错误、业务错误和未知错误统一成前端能识别的格式。这样项目还小的时候就能避免“有的接口返回 true，有的返回字符串，有的直接抛堆栈”的混乱。

有些逻辑需要应用启动成功后执行，比如初始化缓存、检查配置、预热任务或注册本地计划任务。

这类逻辑不要直接写在 main 方法里。Spring Boot 提供了 CommandLineRunner、ApplicationRunner、事件监听等方式。选择哪种不重要，关键是要让启动钩子有明确边界：