1. 为什么需要三层架构刚接触SpringBoot开发时我最常犯的错误就是把所有代码都堆在Controller里。比如查询用户信息直接在Controller里写SQL查询然后返回JSON。看起来简单直接但随着功能增加代码很快就变成了一团乱麻。这时候就需要三层架构来拯救我们了。三层架构就像餐厅的后厨分工服务员Controller负责接待客人厨师Service负责烹饪采购员Dao负责准备食材。各司其职才能高效运转。在实际项目中这种分层带来了三个明显好处代码可维护性当需要修改数据库查询逻辑时你只需要调整Dao层不会影响到其他部分团队协作前端和后端可以并行开发只要约定好接口格式复用性同一个Service方法可以被多个Controller调用我接手过一个老项目所有业务逻辑都写在Controller里一个方法动辄500行。后来用三层架构重构代码量减少了30%新功能开发速度反而提升了一倍。2. 搭建基础项目结构2.1 初始化SpringBoot项目首先用Spring Initializr创建项目我习惯选择Java 17Spring Boot 3.x依赖项Spring Web、Lombok简化getter/setter、H2 Database方便演示curl https://start.spring.io/starter.zip \ -d typegradle-project \ -d languagejava \ -d bootVersion3.1.0 \ -d baseDirspringboot-layered \ -d groupIdcom.example \ -d artifactIddemo \ -d namedemo \ -d dependenciesweb,lombok,h2 \ -o demo.zip解压后用IDE打开你会看到标准的SpringBoot结构。我们需要在src/main/java下新建这些包com.example.demo ├── application ├── controller ├── service ├── dao └── domain ├── dto ├── vo ├── bo └── do2.2 对象类型定义指南很多新手会被各种O搞晕这里用实际案例说明它们的区别DOData Object与数据库表一一对应比如Data public class UserDO { private Long id; private String username; private String password; // 密文存储 private LocalDateTime createTime; }BOBusiness Object包含业务逻辑的对象可能组合多个DOData public class UserBO { private Long userId; private String nickname; private ListString roles; // 从权限表查询得来 private Integer loginCount; // 统计字段 }VOView Object给前端展示的数据通常会过滤敏感信息Data public class UserVO { private String username; private String avatar; private LocalDateTime lastLoginTime; }DTOData Transfer Object用于跨服务调用比如Data public class UserDTO { private String openId; private String unionId; private UserType userType; // 枚举值 }实际项目中我建议先用简单实现等复杂度上来再引入更多对象类型。曾经有个项目过早引入DTO结果90%的DTO和VO完全一样白白增加了转换成本。3. 实现用户查询功能3.1 Dao层实现先创建UserDao接口public interface UserDao { UserDO getById(Long id); ListUserDO listByCondition(UserQuery query); }对应的实现类使用JdbcTemplate也可以换成MyBatis/JPARepository RequiredArgsConstructor // Lombok生成构造函数 public class UserDaoImpl implements UserDao { private final JdbcTemplate jdbcTemplate; Override public UserDO getById(Long id) { String sql SELECT * FROM user WHERE id ?; return jdbcTemplate.queryForObject(sql, (rs, rowNum) - { UserDO user new UserDO(); user.setId(rs.getLong(id)); user.setUsername(rs.getString(username)); // 其他字段... return user; }, id); } }这里有个坑要注意早期的Spring版本可以用Autowired注入JdbcTemplate但现在推荐用构造函数注入Lombok的RequiredArgsConstructor帮我们自动生成。3.2 Service层业务逻辑Service接口定义业务方法public interface UserService { UserBO getUserDetail(Long id); }实现类处理业务逻辑并完成DO→BO转换Service RequiredArgsConstructor public class UserServiceImpl implements UserService { private final UserDao userDao; private final RoleService roleService; // 其他依赖服务 Override public UserBO getUserDetail(Long id) { UserDO userDO userDao.getById(id); if (userDO null) { throw new BusinessException(用户不存在); } UserBO userBO new UserBO(); BeanUtils.copyProperties(userDO, userBO); // 属性拷贝 userBO.setRoles(roleService.getRolesByUserId(id)); return userBO; } }我遇到过有团队在Service层直接返回DO这会导致两个问题1暴露数据库细节 2无法灵活扩展字段。所以一定要记得做对象转换。3.3 Controller层接口设计使用RestController注解创建API端点RestController RequestMapping(/api/users) RequiredArgsConstructor public class UserController { private final UserService userService; GetMapping(/{id}) public ResultUserVO getUser(PathVariable Long id) { UserBO userBO userService.getUserDetail(id); return Result.success(convertToVO(userBO)); } private UserVO convertToVO(UserBO bo) { UserVO vo new UserVO(); vo.setUsername(bo.getNickname()); // 其他字段转换... return vo; } }统一响应格式能让前端处理更规范Data AllArgsConstructor public class ResultT { private int code; private String message; private T data; public static T ResultT success(T data) { return new Result(200, success, data); } }4. 对象转换的最佳实践4.1 手动转换 vs 工具库小项目可以用Spring的BeanUtilsUserVO vo new UserVO(); BeanUtils.copyProperties(bo, vo); // 同名属性自动拷贝复杂项目推荐MapStruct编译时生成转换代码Mapper public interface UserConverter { UserConverter INSTANCE Mappers.getMapper(UserConverter.class); Mapping(source nickname, target username) UserVO toVO(UserBO bo); } // 使用方式 UserVO vo UserConverter.INSTANCE.toVO(bo);我曾经测试过不同方案的性能转换10000次手动setter12msMapStruct15msBeanUtils320msModelMapper450ms4.2 处理集合和嵌套对象对于列表转换推荐这样处理ListUserVO voList boList.stream() .map(UserConverter::toVO) .collect(Collectors.toList());嵌套对象转换示例Mapper public interface OrderConverter { Mapping(target user, source userBO) OrderVO toVO(OrderBO bo); Mapping(source nickname, target name) UserVO toUserVO(UserBO bo); }有个容易踩的坑当BO和VO有相同名称但类型不同的字段时记得用Mapping注解显式指定转换规则。5. 项目结构优化建议5.1 分包策略演进小型项目可以按功能模块分包com.example.order ├── controller ├── service ├── dao └── model大型项目建议按业务域划分com.example ├── user │ ├── web │ ├── service │ └── repository ├── product │ ├── web │ └── service └── common5.2 异常处理统一化创建全局异常处理器RestControllerAdvice public class GlobalExceptionHandler { ExceptionHandler(BusinessException.class) public ResultVoid handleBusinessException(BusinessException e) { return Result.fail(e.getCode(), e.getMessage()); } ExceptionHandler(Exception.class) public ResultVoid handleException(Exception e) { log.error(系统异常, e); return Result.fail(500, 系统繁忙); } }业务异常定义public class BusinessException extends RuntimeException { private final int code; public BusinessException(int code, String message) { super(message); this.code code; } }5.3 接口文档自动化集成Swagger只需两步添加依赖implementation org.springdoc:springdoc-openapi-starter-webmvc-ui:2.0.2配置注解Operation(summary 获取用户详情) GetMapping(/{id}) public ResultUserVO getUser(Parameter(description 用户ID) PathVariable Long id) { // ... }访问http://localhost:8080/swagger-ui.html 就能看到完整的API文档。